SOC-ESP32S3部分：2-2-VSCode进行编译烧录

news2025/5/21 5:33:22

飞书文档https://x509p6c8to.feishu.cn/wiki/CTzVw8p4LiaetykurbTciA42nBf?fromScene=spaceOverview

无论是使用Window搭建IDF开发环境，还是使用Linux Ubuntu搭建IDF开发环境，我们都建议使用VSCode进行代码编写和编译，VSCode界面友好，支持各类免费的插件，可以大大加速我们开发，接下来，我们看看如何使用VScode进行工程编译烧录。

1.1、Window环境-基于VSCode进行编译烧录

1.1.1、配置PowerShell可运行脚本

首先，我们需要打开用管理身份运行PowerShell，在Windows快速开始搜索到Powershell后，右键以管理员身份运行

然后执行

下方指令二选一：
Set-ExecutionPolicy RemoteSigned (建议使用)
Set-ExecutionPolicy Unrestricted
然后选择Y

这个步骤是因为PowerShell默认会限制脚本的运行，而我们后续在VSCode中需要运行配置IDF的脚本，所以提前把这里打开。
设置完成后，运行get-ExecutionPolicy查看是否设置成功

1.1.2、VSCode打开工程文件夹

然后确保我电脑安装了VSCode，如果没安装，可以回到基础课程C语言部分，了解如何安装，然后就可以通过VSCode打开文件夹，这里的文件夹选择我们前面创建的路径，也就是H:\AI\esp32aibox，为什么选择这里而不是H:\AI\esp32aibox\app\hello_world文件呢？我们接着看

这样打开后，我们就可以看到有app和Espressif两个文件夹，app中是我们上节课复制的hello_world工程，Espressif是IDF的源码，这样的方式方便我们编程时，参考IDF的示例和API函数。

接着我们新建一个终端

我们可以看到VSCode的底部出现了一个powershell的终端，这就是使用VSCode的好处，编辑源码，编译，烧录都可以在一个IDE完成，这样，我们就不用手动另外在打开powershell啦

然后，我们执行脚本配置下IDF的环境变量

进入IDF路径
PS H:\AI\esp32aibox> cd .\Espressif\frameworks\esp-idf-v5.4\
配置环境变量
PS H:\AI\esp32aibox\Espressif\frameworks\esp-idf-v5.4> .\export.ps1

或者带路径一步执行
PS H:\AI\esp32aibox>.\Espressif\frameworks\esp-idf-v5.4\export.ps1

重要：环境变量配置这个操作每次开启一个新的终端或重启VSCode都需要做哦，否则会出现找不到idf.py

报错&解决说明

这是因为电脑本地的python环境影响导致，需要修改电脑环境变量为idf的python路径，如果不想，最好把python环境变量也加到PATH

xxx你的路径xxx\Espressif\tools\idf-python\3.11.2\

后续的编译、烧录流程和前面是一样的。

切换到工程目录
PS H:\AI\esp32aibox\Espressif\frameworks\esp-idf-v5.4> cd ../../../
PS H:\AI\esp32aibox> cd .\app\hello_world\
设置、编译、烧录
PS H:\AI\esp32aibox\app\hello_world> idf.py set-target esp32-s3
PS H:\AI\esp32aibox\app\hello_world> idf.py build
PS H:\AI\esp32aibox\app\hello_world> idf.py flash monitor

1.2、Linux环境-基于VSCode进行编译烧录

如果是Linux环境，想在Window内使用VSCode进行编译和烧录，需要安装SSH服务

Ubuntu SSH服务安装：

在ubuntu终端中执行：
sudo apt-get install openssh-server
sudo /etc/init.d/ssh start
ps -e|grep ssh
sudo passwd root 若未设置过root密码，可自行选择设置
查看ubuntu ip确定和windows网段一样
ifconfig

然后在Window VSCode中通过SSH命令行方式访问Ubuntu

打开VSCode安装C/C++、SSH客户端插件