[全网首发]微雪ESP32-S3/ESP-32使用VScode+ESP-INF环境搭建小白式讲解完整步骤(ESP-32最简入门)

Tips：由于博主不再研究单片机，因此本文不再更新新的内容，除非文章内容有错，也不会解决您的提问，仅日常维护纠错，望谅解！

一、前言

        相信ESP32环境搭建估计劝退了至少五成的同学们，国内相关有用的教程少之又少，在此整合全网各大平台、ChatGPT、博主自己试错等所有的ESP-32环境搭建资料，为入门的同学们开一条路！

        本文仅表达博主个人观点，如有异议请多多指教。

二、认识ESP-32

        1.ESP-32是什么？

                一种单片机，可烧录代码程序到上面运行，从而不使用计算机来运行。

        2.ESP-32能够干什么？

                ESP32 系列模组具备卓越的性能和丰富的外设，集 Wi-Fi、传统蓝牙、低功耗蓝牙为一体，提供高度集成的解决方案，广泛适用于各类物联网应用。

        3.ESP-32难学吗？

                ESP-32前期难主要难在环境搭建上，尤其是VScode等。不过本篇文章可以让你在30分钟内搞定！

三、开始搭建VScode作为IDE环境

1.下载 Espressif-IDE 和 ESP-IDF 离线安装包

方式一：从官网上下载：

链接：官网下载链接

方式二：

        百度网盘 提取码：evtk

接下来跟着安装界面安装即可。

2.VScode安装ESP-INF插件

3.将 OpenOCD 添加到环境变量

OpenOCD（Open On-Chip Debugger）是一个开源的调试工具，主要用于嵌入式开发中的调试、编程和芯片控制。它能够通过JTAG、SWD等接口与微控制器（如ESP32）通信，实现调试和烧录功能。对于嵌入式开发者来说，OpenOCD可以提供以下功能：

1. 调试：支持设置断点、单步执行、查看寄存器和内存等操作，帮助开发者定位代码中的问题。
2. 烧录：可以直接通过JTAG或SWD将程序代码烧录到芯片的Flash中。
3. 芯片控制：可以控制芯片的运行状态，如复位、暂停和继续运行等。
4. 接口兼容性：支持多种调试接口，包括JTAG、SWD和FTDI，适用于各种微控制器平台（如ARM、RISC-V和ESP32等）。

找到以下路径：

 你的安装路径+\Espressif\tools\openocd-esp32\v0.12.0-esp32-20240318\openocd-esp32\bin

（注意版本号）

如果你没有这样的目录，说明你的ESP-INF安装失败，请回到上一步检查是否有错！！

（1）右键"此电脑"->"属性"

（2）高级系统设置

（3）环境变量

（4）系统变量-PATH-编辑

（5）新建路径：你的安装路径+\Espressif\tools\openocd-esp32\v0.12.0-esp32-20240318\openocd-esp32\bin（注意版本号是否正确）

（6）在cmd中输入指令：openocd，如果出现类似以下界面就说明成功了。

4.进入 VScode 完成配置

（1）进入VScode，左上角"查看"->"命令面板"输入：esp-idf: configure esp-idf extension

（2）稍等片刻后，选择Express

（3）选择Espressif下载源（更适合国内下载）

（4）点击Install（安装），然后等待下载完成

5.创建例程

（1）进入VScode，左上角"查看"->"命令面板"输入：esp-idf:show examples projects

（2）选择hello_world

（3）创建例程

（4）任意选择例程创建位置

6.修改配置

（1）右键"此电脑"->"管理"->"设备管理器"->"端口"，在此处查看ESP-32使用的端口，记住这个端口

（2）回到VScode，修改COM为当前ESP-32使用的端口

（3）（可选）修改驱动对象，例如如果你使用的是ESP-32 S3那就选择esp32s3，然后稍等片刻。

（4）对于OpenOCD路径，选择任意一个（推荐第三个）

（5）（由于只显示一次博主没有截到图）

新版VScode这里会弹出选择JTAG、UART和FTDI，这里对应的应该是ESP-32板子上USB连接口位置处写的调试接口，如果不知道建议无脑选UART，如果之后编译出错就改成JTAG（具体怎么改：例如你选的UART，那么就在工作区里搜索UART，然后对应着修改值）

7.状态栏介绍（结束）

• ①SDK 配置编辑器，ESP-IDF很多功能与配置可以在其内修改
• ②全部清理，清空所有编译文件，
• ③编译
• ④当前下载方式，默认为UART
• ⑤烧录当前固件，请在编译后进行
• ⑥打开串口监视器，用于查看串口信息
• ⑦编译，烧录，打开串口监视器 一体按键（调试时最常用）

(1)点击那个像小火苗一样的按钮开始译，烧录，打开串口监视器

（2）第一次编译会花很长时间，需要耐心等待。下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启

        如果你完成到这一步图中一样，那么恭喜你，成功搭建好了VScode的ESP-32环境！！快去喝一杯庆祝吧！

四、参考链接

1.VSCode STM32 OpenOCD Debug无法启动的问题_

2.openOCD安装 极简教程_openocd教程-优快云博客

3.ESP32-S3-Touch-LCD-4.3 - Waveshare Wiki

4.快速入门 - ESP32 - — ESP-IDF 编程指南 v5.2.3 文档

5.Espressif IDF for VSCode 爬坑之路二：ESP32 的 JTAG 调试（OpenOCD & GDB）_

6.ESP-IDF环境安装出现问题（报错python.exe -m pip“ is not valid. (ERROR_INVALID_PIP)）

7.感谢ChatGPT在危急时刻提供的帮助（

8.感谢我家的猫猫陪了我一下午和晚上来解决环境搭建问题并写下这篇文章，只是不要在我敲代码的时候舔我的手就好了。