vscode+ESP-IDF开发环境搭建教程，附带python和git安装教程、安装出错踩坑经验、最新版安装包。

文章目录

• 前言
• 一、软件下载
• • （1）ESP-IDF-V5.0 SDK：
  • （2）Visual Studio Code：
  • （3）Git：
  • （4）Python：
• 二、软件安装
• • （1）Python安装：
  • （2）Git安装：
  • （3）ESP-IDF安装：
  • （4）VScode安装：
• 三、VScode+ESP-IDF环境搭建：
• 四、安装失败经验贴：
• • PS:粉丝反馈的失败情况分析及解决措施：
• 总结

前言

巨详细一站式VScode+ESP-IDF的开发环境搭建教程，附带Python和Git安装教程、安装出错踩坑经验，小白跟我无脑操作也能一次点亮，文章最后附最新版安装包。

一、软件下载

（1）ESP-IDF-V5.0 SDK：

方式1：乐鑫官网.

方式2：GitHub官网
（注意：方式2不需要单独安装，仅在搭建开发环境时有所不同）

（2）Visual Studio Code：

Visual Studio Code官网：下载最新版VScode.

（3）Git：

Git官网：下载最新版Git即可。
关于Git的使用可以参考我的另一篇文章，里面有详细的安装、使用教程及技巧。

Git入门指南–从入门到入土

（4）Python：

Python官网：下载最新版Python即可.

二、软件安装

（1）Python安装：

①建议先装Python，否则ESP-IDF会安装失败，记得勾选Add Python.exe to PATH，等待安装完成。

②在Python安装成功后，需要更新pip：
win+R，输入cmd：
1.在命令框中输入pip list查看当前Python版本；
2.在命令框中输入python.exe -m pip install --upgrade pip，对pip进行更新；
3.在命令框中输入pip list再次查看当前Python版本是否更新成功。

（2）Git安装：

一直next就可以了。
关于Git的使用可以参考我的另一篇文章，里面有详细的安装、使用教程及技巧。

Git入门指南–从入门到入土

（3）ESP-IDF安装：

仅方式1进行此步骤
①双击打开esp-idf-tools-setup-offline-5.0.1.exe，选择’简体中文’后点击’确定’.

②选择’我同意此协议’后点击’下一步’.

③点击’下一步’.

④选择安装路径，点击’下一步’.

⑤选择所有的组件，点击’下一步’.

⑥点击’安装’，等待安装完成.

（4）VScode安装：

①点击’我同意此协议’后，点击’下一步’.

②选择安装位置后，点击’下一步’.

③点击’下一步’.

④选择所有的选项后，点击’下一步’.

⑤点击安装，等待安装完成。
注意：PATH重启后生效，建议在装完所有软件之后，开始搭建VScode开发环境之前重启一次电脑。

三、VScode+ESP-IDF环境搭建：

初次使用时，建议安装中文插件，注意：该插件在重启VScode后生效.

①在左侧搜索栏输入ESP-IDF，点击Espressif IDF插件的Install进行安装.

②安装完成后，会在左侧边框显示图标.

③按住Ctrl+Shift+P打开搜索框，输入ESP-IDF减少搜索范围，选择ESP-IDF:配置ESP-IDF插件：

④安装ESP-IDF:
方式1：
1.选择USE EXISTING SETUP.

2.选择图示选项，点击即可完成环境搭建。若无，则在上述软件安装时ESP-IDF安装失败.

方式2：
1.选择ADVANCED.

2.选择GitHub仓库下载的f-c-idf50release\esp-idf位置，点击Install.

3.点击Download Tools.

⑤出现图示字样即代表安装成功.

四、安装失败经验贴：

安装失败大多是因为Python环境搭建时出错而安装失败，但无论何种原因导致安装失败，都需要彻底删除VScode、ESP-IDF、Python及其残余文件后再重新安装，建议删除完毕后重启一次电脑。
①删除软件：使用geek软件进行删除。
②删除残余文件：
1.win + r 打开运行 %appdata% 回车，删除 Code 文件夹

2.地址栏输入 %userprofile% 回车，删除 .vscode 文件夹

PS:粉丝反馈的失败情况分析及解决措施：

后台粉丝兄弟反馈安装时遇到如下情况，大致意思是说VScode安装包是usersetup版，不是systemsetup版。这位兄弟从上文中给出的VScode官网重新下载systemsetup版，然后根据本文也是一次点亮。至于这两个版本的区别，如下我也问了一下ChatGPT。
同时，也希望大家有什么问题都可以后台联系我，也欢迎大家进群一起交流学习、一起变强。

总结

最新版安装包：
链接：https://pan.baidu.com/s/1FmKFtoPVlkEx0to8oeS1kA
提取码：0axs

如有任何安装问题或其他技术问题，请添加好友，一对一免费指导安装。

收藏不迷路，如果感觉有用的话欢迎各位大家一键三连。祝大家技术越来越牛，必拿下！！

来源地址：https://blog.csdn.net/weixin_42037809/article/details/130612120