【ESP32填坑日记】环境篇① 一站式VScode+ESP-IDF搭建教程，附带Python出错填坑经验_eps-idf git安装

（注意：方式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:粉丝反馈的失败情况分析及解决措施：

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


2、后台粉丝兄弟补充：提示Python出错大多是因为使用的是国外Python包的仓库源，需要更改为国内Python包的仓库源。如果有Python那里出错的兄弟，记得按照按照<四、安装失败经验贴>里的步骤先卸载，再使用<六、总结>链接里的安装包重新安装一遍就能正常跑起来了。

五、免安装版：

①下载并解压免安装版安装包。
免安装版链接：https://pan.baidu.com/s/1tE1fXHqVJ6QhAV_he3DopA?pwd=NFDY
提取码：NFDY
说明：该版本相当于是离线版，与上述普通版在功能方面并无任何差异，配备的是ESP-IDF v5.0.0，可以与普通安装版共存，两者并不冲突。

②在D盘根目录新建0_soft_tool文件夹，再在0_soft_tool里新建0_esp_idf文件夹，将上述免安装版安装包解压到0_esp_idf文件下。

③直接双击打开vscode.exe，然后选择“文件”->“打开文件夹”选择你的工程文件夹就可快乐的玩耍了。
自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数嵌入式工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年嵌入式&物联网开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上嵌入式&物联网开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新

如果你觉得这些内容对你有帮助，可以+V：Vip1104z获取！！！ （备注：嵌入式）

最后

资料整理不易，觉得有帮助的朋友可以帮忙点赞分享支持一下小编~

你的支持，我的动力；祝各位前程似锦，offer不断，步步高升！！！

tps://img-community.csdnimg.cn/images/73bb5de17851459088c6af944156ee24.jpg" alt=“img” style=“zoom: 67%;” />

最后

资料整理不易，觉得有帮助的朋友可以帮忙点赞分享支持一下小编~

你的支持，我的动力；祝各位前程似锦，offer不断，步步高升！！！

更多资料点击此处获qu！！