序本篇默认读者知晓Ubuntu系统终端等操作的基础知识一、vscodeespidf(1)vscode下载Visual Studio Code简称“VS Code”是Microsoft向开发者们提供的一款真正的跨平台编辑器。VS Code下载地址Download Visual Studio Code - Mac, Linux, Windows点击上方下载地址后如下图点击下载.deb(2)vscode的.deb安装方法.deb终端安装命令方法方法 1使用dpkg命令安装.deb包打开终端使用dpkg命令安装.deb包sudo dpkg -i /path/to/package.deb将/path/to/package.deb替换为.deb文件的实际路径。sudo命令sudo命令在Linux系统中非常重要它允许普通用户以超级用户或其他指定用户的身份执行命令。这样系统管理员可以授予用户执行特定命令的权限而无需共享root用户的密码从而提高了系统的安全性。如果安装过程中出现依赖性问题可以使用以下命令修复依赖sudo apt-get install -f这会自动安装所需的依赖并完成.deb包的安装。方法n剩余详见在 Ubuntu 上安装 .deb 软件包有几种方法_ubuntu deb安装命令-CSDN博客(3)vscode常用插件安装运行VSCode并安装基础扩展插件①点击【Extensions】扩展图标②选择C/C扩展插件点击【Install】③选择舰种扩展插件点击【Install】下图插件为vscode从英文界面变为中文插件的插件建议安装(4)配置文件(为后续多版本idf做准备)如上图先点击左下角的齿轮图标再点击配置文件及子页面的配置文件如下图点击新建配置文件输入对应espidf版本(如果不知道自己要下的版本可以先随便写后续可以改)以作区分再点击创建。再点击对应创建文件的√使当前工程使用此配置文件即活动状态。(5)基于设置好的配置文件安装espidf环境1、准备工作1.1、获取espidf编译所需的软件包为了在 ESP32 中使用 ESP-IDF需要根据操作系统安装一些软件包。sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-02、在vscode安装espidf插件按照(3)vscode常用插件的安装方法安装epidf插件不同时期espidf插件图标有所不同现在自动安装的是新的插件版本可以安装特定版本v1.10.0安装完成后vscode左侧栏会出现下图红框框住的图标右侧页面会出现下图界面若未出现或者你把他关掉了可通过点击vscode左侧espidf插件图标再按照下图点击红框所示项等待vscode右下角出现的进度条跑完即可看到该界面进入之后选中【EXPRESS】①选择类型乐鑫的服务器这样下载会更快一些②点击选择版本下拉框可选择对应版本若没有你需要的版本可以点击展示所有espidf标签③选择python工具路径选择系统python3(一般会自动选择不用改)④然后点击【Install】开始安装然后就慢慢等待安装完成看到这个界面恭喜您正确的安装完成了。注随着插件升级不一定就是下图界面若出现其他界面请自行辨别。(6)Ubuntu串口为串口增加权限因为默认情况下只有root用户和属于dialout组的用户会有读写串口的权限因此直接把自己的用户加入到dialout组就可以了。操作完命令后要重启一下就永久生效了。在终端中输入以下命令sudo usermod -a -G dialout $USER二、编译烧录教程当我们改好代码后就可以编译出固件了编译完成后就需要烧录到我们相应的处理器中了。编译(build)编译需事先选择芯片类型烧录方法一推荐连接电脑与硬件的usb(若需开机的硬件需开机)(常规设备usb)(新版豆丁机器人使用串口需要驱动见上文)设置对应的dev点击下图图标即可烧录。注日志输出是下图图标右侧的显示器图标。一般的烧录成功如图所示处理器中无程序日志如下图。注意这里有几种情况可能会导致烧录不进去。1.处理器中无程序。2.上次烧录的程序有bug导致不停重启。以上几种情况可以先同时按住对应处理器的RST和BOOT按键先松开RST再松BOOT后再进行烧录烧录完成后需要按rst重启。或者断电按住处理器对应boot键再上电点烧录再松开boot。处理器中无程序日志如下图。烧录失败如下图方法二ESP32s3烧录bin乐鑫下载工具flash_download_tool_乐鑫flash下载工具-CSDN博客三、特殊情况1、idf5.5版本需要python3.10-venvsudo apt update # 先更新软件源可选但推荐 sudo apt install -y python3.10-venv
关于Ubuntu系统下-espidf环境搭建方法
发布时间：2026/7/21 17:57:10
序本篇默认读者知晓Ubuntu系统终端等操作的基础知识一、vscodeespidf(1)vscode下载Visual Studio Code简称“VS Code”是Microsoft向开发者们提供的一款真正的跨平台编辑器。VS Code下载地址Download Visual Studio Code - Mac, Linux, Windows点击上方下载地址后如下图点击下载.deb(2)vscode的.deb安装方法.deb终端安装命令方法方法 1使用dpkg命令安装.deb包打开终端使用dpkg命令安装.deb包sudo dpkg -i /path/to/package.deb将/path/to/package.deb替换为.deb文件的实际路径。sudo命令sudo命令在Linux系统中非常重要它允许普通用户以超级用户或其他指定用户的身份执行命令。这样系统管理员可以授予用户执行特定命令的权限而无需共享root用户的密码从而提高了系统的安全性。如果安装过程中出现依赖性问题可以使用以下命令修复依赖sudo apt-get install -f这会自动安装所需的依赖并完成.deb包的安装。方法n剩余详见在 Ubuntu 上安装 .deb 软件包有几种方法_ubuntu deb安装命令-CSDN博客(3)vscode常用插件安装运行VSCode并安装基础扩展插件①点击【Extensions】扩展图标②选择C/C扩展插件点击【Install】③选择舰种扩展插件点击【Install】下图插件为vscode从英文界面变为中文插件的插件建议安装(4)配置文件(为后续多版本idf做准备)如上图先点击左下角的齿轮图标再点击配置文件及子页面的配置文件如下图点击新建配置文件输入对应espidf版本(如果不知道自己要下的版本可以先随便写后续可以改)以作区分再点击创建。再点击对应创建文件的√使当前工程使用此配置文件即活动状态。(5)基于设置好的配置文件安装espidf环境1、准备工作1.1、获取espidf编译所需的软件包为了在 ESP32 中使用 ESP-IDF需要根据操作系统安装一些软件包。sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-02、在vscode安装espidf插件按照(3)vscode常用插件的安装方法安装epidf插件不同时期espidf插件图标有所不同现在自动安装的是新的插件版本可以安装特定版本v1.10.0安装完成后vscode左侧栏会出现下图红框框住的图标右侧页面会出现下图界面若未出现或者你把他关掉了可通过点击vscode左侧espidf插件图标再按照下图点击红框所示项等待vscode右下角出现的进度条跑完即可看到该界面进入之后选中【EXPRESS】①选择类型乐鑫的服务器这样下载会更快一些②点击选择版本下拉框可选择对应版本若没有你需要的版本可以点击展示所有espidf标签③选择python工具路径选择系统python3(一般会自动选择不用改)④然后点击【Install】开始安装然后就慢慢等待安装完成看到这个界面恭喜您正确的安装完成了。注随着插件升级不一定就是下图界面若出现其他界面请自行辨别。(6)Ubuntu串口为串口增加权限因为默认情况下只有root用户和属于dialout组的用户会有读写串口的权限因此直接把自己的用户加入到dialout组就可以了。操作完命令后要重启一下就永久生效了。在终端中输入以下命令sudo usermod -a -G dialout $USER二、编译烧录教程当我们改好代码后就可以编译出固件了编译完成后就需要烧录到我们相应的处理器中了。编译(build)编译需事先选择芯片类型烧录方法一推荐连接电脑与硬件的usb(若需开机的硬件需开机)(常规设备usb)(新版豆丁机器人使用串口需要驱动见上文)设置对应的dev点击下图图标即可烧录。注日志输出是下图图标右侧的显示器图标。一般的烧录成功如图所示处理器中无程序日志如下图。注意这里有几种情况可能会导致烧录不进去。1.处理器中无程序。2.上次烧录的程序有bug导致不停重启。以上几种情况可以先同时按住对应处理器的RST和BOOT按键先松开RST再松BOOT后再进行烧录烧录完成后需要按rst重启。或者断电按住处理器对应boot键再上电点烧录再松开boot。处理器中无程序日志如下图。烧录失败如下图方法二ESP32s3烧录bin乐鑫下载工具flash_download_tool_乐鑫flash下载工具-CSDN博客三、特殊情况1、idf5.5版本需要python3.10-venvsudo apt update # 先更新软件源可选但推荐 sudo apt install -y python3.10-venv
