VS Code 与 ESP32 官方SDK配置

开发基于 ESP XXX 微控制器应用，最简单的环境搭建方案是像 MicroPython、CircuitPython、NanoFramework 等，下载固件，直接开刷；或者基于 Arduino 的开发组件，安装起来都容易。不过，这些框架是经过封装的，就目前而言，它们的功能还不完善，功能上肯定没有乐鑫官方的 SDK 完整；当然了，也不是说这些框架不能用，只要能满足你的需求就可以用。

乐鑫官方的 SDK 支持 Eclipse 、VS Code 插件方式使用 IDE。对于咱们一路喜欢 VS 的伙伴来说，当然是用 VS Code 写代码舒服了。本来嘛，在VS Code 中，只要安装好 ESP - IDF 插件，然后运行 ESP-IDF: 配置 ESP-IDF 插件 就会自动下载 SDK 和工具。然而由于某些你懂的不可抗因素，这个方案是很难安装成功的。SDK 部分多折腾几次都能下载，但后面那十几个工具就没那么好运气了，老是失败。

经过老周的各种尝试，只有使用离线安装这一招最靠谱。打开 https://dl.espressif.com/dl/esp-idf/?idf=4.4。

Windows 上还是很好弄的（Linux上可以手动下载.tar.gx，然后解压），上图中，点击页面中的 Offline installer，下载离线安装包，大概 1.5 G，对于现在的网速来说，不算大。

下载之后，直接运行。

下一步。

这里它会检查你的系统环境适不适合安装，如果没有问题，Next 安钮将可用。如果有问题，Apply Fixes 按钮可用，点一下让它自动修复问题。其实这里一般不会有大问题，可能会存在的就是文件名字符数据的限制，点击 Apply Fixes 按钮即可。然后点 Next。

版本当然选新的，安装目录这里最好改一下，这货很不懂事，居然默认安装到桌面上。

上一步选的目录是放 SDK 的，这一步选的是放 SDK 工具的目录，自己选一个吧，最好不要带空格，出错的概率达到 89.965%；也最好不要包含汉字，出错率达 92.333%。

这个地方基本上可以全部清空，如果你要用 Eclipse ，就选上吧。

这里让你核对一下你前面所选的参数是否正确，不符合你的要求的话，就返回去重来。

接着一路下一步，然后坐和等待。

最后这里，勾上这个选项，让杀毒软件跳过对编译时的文件扫描。

Python 是内置的，这个没办法，如果你安装了多套工具，比如 Thoony、Arduino IDE等，都会内置 Python，所以会多次重复安装。Python 这货也是个头疼事，如果硬盘空间不紧张，就随它去吧，因为这厮在版本兼容问题上也特严重，不同程序内置 Python 可能会减少许多问题。

然后干吗呢？对，环境变量，打开【设置】【系统】【关于】。

点击“高级系统设置”。

然后在打开的对话框中点击“环境变量”。

至于说配置用户级的环境变量还是机器级的环境变量，那随你便，如果电脑是你一个人用的，那无所谓。如果是和“闺蜜”共享一台电脑，最好配置为用户级别的，免得“闺蜜”不小心刺探到重要军情。哈哈，这情节差点变成琼瑶剧了。

环境变量名为 IDF_PATH，值是SDK的所在路径，就是你刚刚安装时选的路径。例如，C:\\Users\\八格牙路\\esp\\esp-idf，注意要指向 esp-idf，因为文件是在这个文件夹下面的，指向它才能找到文件。IDF_TOOLS_PATH 是刚才安装程序自动设置了的。

最后，打开VS Code，安装 Espressif IDF、C/C++、CMake 等插件。其实，只要安装 Espressif IDF 就行，其他的组件会自动安装。

按【F1】，找到命令“配置ESP IDF扩展”，拼命点它就是了，让它执行。

这货能识别出我们刚刚安装的SDK和工具集，选择第三项，使用已有的配置。

打开【设置】窗口，找到【扩展】【ESP-IDF】，在右面页面中往下翻，找到配置 Python 解析器的路径选项，设置成我们刚刚安装好的内置的Python二进制文件。

带有 “Win” 的表示 Windows 平台专用，如果不这样配置，那么那个内置的 Python 就没有用处了。老周这机器上默认装的是 Python 3.9 的，实话告诉你，不兼容的，会报错。所以这个路径必须改成内置的——刚刚安装时选的 xxxxx\\.espressif 目录下的。如果你的机器装的 Py 版本和内置的版本相同，应该能用的，不能用了再改。

还有一处，咱们在把编译好的 .bin 刷到 ESP32 板子上时，一般咱们买的板子是 Micro-USB 的，所以，烧写模式是 UART。于是，把 Flash Type 改一下。这个后面你在烧写是可以改的，不过现在提前改好也省了些功夫。

完工，为了使用一些环境变量能生效，可以重启一下 VS Code，要是环境变量是配置在机器级别的，估计连电脑也要重启。

现在，咱们试试能不能用。

1、启动VSC，打开一个目录作为工作区，这个可以随意发挥。

2、在VS Code中按【F1】，选择“从扩展模板创建项目”。

3、选择 Use current folder，即使用你打开的工作目录。

4、在选择项目模板时，选最后一个，template-app，这TM很不友好，居然这样创建项目。

5、这货真是的，还会打开一个新的 VS Code 窗口来创建项目。然后让你选编译器，反正下面列出的几个都不是，就选第一项好了 —— Scan Kits。

6、打开 main / main.c 文件，把代码中 app_main 函数中，后半部分，也就是那个 for 循环倒数 10 秒重启开发板那一段删掉，不然烧上去后板子老是重启，不好玩。

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_system.h"
#include "esp_spi_flash.h"

void app_main(void)
{
    printf("Hello world!\n");

    /* Print chip information */
    esp_chip_info_t chip_info;
    esp_chip_info(&chip_info);
    printf("This is ESP32 chip with %d CPU cores, WiFi%s%s, ",
            chip_info.cores,
            (chip_info.features & CHIP_FEATURE_BT) ? "/BT" : "",
            (chip_info.features & CHIP_FEATURE_BLE) ? "/BLE" : "");

    printf("silicon revision %d, ", chip_info.revision);

    printf("%dMB %s flash\n", spi_flash_get_chip_size() / (1024 * 1024),
            (chip_info.features & CHIP_FEATURE_EMB_FLASH) ? "embedded" : "external");
}

app_main 类似于 main 入口点，经过封装，就像以前写 Windows 程序那样，有个 WinMain。

7、把 ESP32 开发板连上电脑，按【F1】，选择命令“选择要使用的烧录端口”，然后根据你电脑识别的结果选。

8、点击底部工具栏中的“Build, Flash and Monitor”，这个按钮可神了，编译、烧录、打开串口监视器，三个任务自动完成。

9、然后又是坐和等待，C 语言你懂的，编译较慢。

注意观察，如果看到下面这样的输出，说明程序成功运行了。

好了，大功告成，ESP 32 + VS Code 的开发环境就搭建好了。