2025最新版 Windows下esp32 Vscode环境配置全流程

Q: 腾讯云 版权所有 深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号 腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号 前言

腾讯云 版权所有 深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号 腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号 前言 伴随着AI小智的大火，不少发烧友也想制作一个AI小智，但苦于开发环境的搭建，本文旨在介绍如何搭建环境，学识有限，如有不妥之处，望各位斧正。 安装程序会检查你当前系统有没有打开"长路径支持"，因为 GNU 编译器产生的编译文件会有非常深的目录结构，如果不支持长路径，编译可能出现文件不存在，目录不存在等奇怪的错误。这里单击应用修复按钮，可以修复这个问题。在弹出的确认对话框中，选择是，开始修复。 修复完成如图 如果修复失败可以手动修改注册表来支持长路径（具体百度一下，我没有遇到） 提示修复完成后，点击下一步进入配置安装路径，如下图所示：

Q: 记住该路径，后续需要用到，路径不能有中文！！！ 设置安装路径后点击 “下一步”选项，进入确认安装组件界面，这里全部打勾，默认完全安装时 ESP32C2 是不打勾的（如下图所示），看需要自己选择。然后单击下一步。 我们选择全部安装。点击下一步再次确认安装目录信息，然后单击安装。安装完成，三个全部勾选，1、2 用于测试环境安装是否成功，3 是将 ESP-IDF 工具链加入杀毒工具排除项，以加快编译速度，如下图所示：

记住该路径，后续需要用到，路径不能有中文！！！ 设置安装路径后点击 “下一步”选项，进入确认安装组件界面，这里全部打勾，默认完全安装时 ESP32C2 是不打勾的（如下图所示），看需要自己选择。然后单击下一步。 我们选择全部安装。点击下一步再次确认安装目录信息，然后单击安装。安装完成，三个全部勾选，1、2 用于测试环境安装是否成功，3 是将 ESP-IDF 工具链加入杀毒工具排除项，以加快编译速度，如下图所示：

Emily Johnson

-Mar 14, 2026, 4:13 PM

参考官方的流程使用vscode开发esp32，先搭建vscode的esp32开发环境。这里直接参考官网的流程搭建就可以了。先贴上官方的说明（直接复制过来的）。但是在最后一步创建python虚拟环境时报错了，后面会介绍如何解决。（也是为什么要写一下这篇文章的原因）选择要下载的 ESP-IDF 版本，或使用 Find ESP-IDF in your system 选项搜索现有的 ESP-IDF 目录。选择保存 ESP-IDF 工具的位置 (IDF_TOOLS_PATH)，默认情况下在 Windows 系统中为 %USERPROFILE%\.espressif，在macOS/Linux 系统中为 $HOME\.espressif。确保 IDF_TOOLS_PATH 中没有空格，避免出现构建问题。此外，要注意 IDF_TOOLS_PATH 与 IDF_PATH 不能在相同目录下。这个教程手把手带你简单实现Windows+vscode环境开发esp32(esp-idf)。教程会讲述两个开发实现方式：

两种开发方式都是基于esp-idf原本的开发模式进行开发，可以让你后续在其他平台都能自如适应。定制的VScode插件能辅助你在Windows、Linux、MAC平台更高效地进行esp-idf项目的开发。如果通过看文档教程无法实现效果，请观看此文档教程的视频教程：https://www.bilibili.com/video/BV1YUL1z3Ee2 注意：资料提供的软件包后续可能会更新，如果进行了更新，那么文件名称会改变，但是改变的只会是版本号，关键信息不会改变，比如esp-idf-tools-setup-offline-5.4.1.exe，不管版本如何变化都会保留有esp-idf-tools-setup-offline关键字，通过该关键字对应即可。如果电脑没有安装VScode，那么先双击安装这个软件：VSCodeUserSetup-x64-1.99.3.exe Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved.

腾讯云版权所有深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号腾讯云计算（北京）有限责任公司京ICP证150476号 | 京ICP备11018762号前言伴随着AI小智的大火，不少发烧友也想制作一个AI小智，但苦于开发环境的搭建，本文旨在介绍如何搭建环境，学识有限，如有不妥之处，望各位斧正。安装程序会检查你当前系统有没有打开"长路径支持"，因为 GNU 编译器产生的编译文件会有非常深的目录结构，如果不支持长路径，编译可能出现文件不存在，目录不存在等奇怪的错误。这里单击应用修复按钮，可以修复这个问题。在弹出的确认对话框中，选择是，开始修复。修复完成如图如果修复失败可以手动修改注册表来支持长路径（具体百度一下，我没有遇到）提示修复完成后，点击下一步进入配置安装路径，如下图所示：

记住该路径，后续需要用到，路径不能有中文！！！设置安装路径后点击 “下一步”选项，进入确认安装组件界面，这里全部打勾，默认完全安装时 ESP32C2 是不打勾的（如下图所示），看需要自己选择。然后单击下一步。我们选择全部安装。点击下一步再次确认安装目录信息，然后单击安装。安装完成，三个全部勾选，1、2 用于测试环境安装是否成功，3 是将 ESP-IDF 工具链加入杀毒工具排除项，以加快编译速度，如下图所示：

People Also Search

参考官方的流程使用vscode开发esp32，先搭建vscode的esp32开发环境。这里直接参考官网的流程搭建就可以了。先贴上官方的说明（直接复制过来的）。但是在最后一步创建python虚拟环境时报错了，后面会介绍如何解决。（也是为什么要写一下这篇文章的原因）选择要下载的 ESP-IDF 版本，或使用 Find ESP-IDF In Your System

两种开发方式都是基于esp-idf原本的开发模式进行开发，可以让你后续在其他平台都能自如适应。定制的VScode插件能辅助你在Windows、Linux、MAC平台更高效地进行esp-idf项目的开发。如果通过看文档教程无法实现效果，请观看此文档教程的视频教程：https://www.bilibili.com/video/BV1YUL1z3Ee2 注意：资料提供的软件包后续可能会更新，如果进行了更新，那么文件名称会改变，但是改变的只会是版本号，关键信息不会改变，比如esp-idf-tools-setup-offline-5.4.1.exe，不管版本如何变化都会保留有esp-idf-tools-setup-offline关键字，通过该关键字对应即可。如果电脑没有安装VScode，那么先双击安装这个软件：VSCodeUserSetup-x64-1.99.3.exe Copyright © 2013 - 2026 Tencent

记住该路径，后续需要用到，路径不能有中文！！！设置安装路径后点击 “下一步”选项，进入确认安装组件界面，这里全部打勾，默认完全安装时 ESP32C2 是不打勾的（如下图所示），看需要自己选择。然后单击下一步。我们选择全部安装。点击下一步再次确认安装目录信息，然后单击安装。安装完成，三个全部勾选，1、2 用于测试环境安装是否成功，3 是将 ESP-IDF 工具链加入杀毒工具排除项，以加快编译速度，如下图所示：

2025最新版 Windows下esp32 Vscode环境配置全流程

People Also Search

腾讯云 版权所有 深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号 腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号 前言

腾讯云版权所有深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号腾讯云计算（北京）有限责任公司京ICP证150476号 | 京ICP备11018762号前言