VSCode配置Arduino运行环境 - 硬件编程入门指南

说个前提——VSCode默认是不支持Arduino开发的，它不像Keil那样装好就能用，得自己手动搭个桥。这个桥就是 arduino-cli。插件要能正常工作，arduino.path 这个设置项必须指向那个可执行文件，而不是解压目录本身。不然，连工具栏上的“Verify”按钮都会是灰色的，根本点不动。

VSCode 自己可没法直接开发 Arduino，必须手动装好 arduino-cli，并且把路径明明白白地告诉插件，否则连个“验证”按钮你都点不了。

arduino.path 得是文件路径，不是文件夹路径

插件默认会去系统环境变量PATH里找 arduino-cli，但这招经常不好使——尤其是在Windows上。路径里带上反斜杠、空格或者中文字符，直接就报错 spawn ENOENT；macOS上如果是用Homebrew装的，那路径会因为芯片架构不同（比如 /opt/homebrew/bin/arduino-cli 和 /usr/local/bin/arduino-cli）而搞混，导致找不到。

• Windows用户：下载好 arduino-cli_0.41.2_Windows_64bit.zip 后，解压。把 arduino-cli.exe 放到一个没有空格和中文的路径下，比如 C:toolsarduino-cli.exe。然后在VSCode设置里搜 arduino.path，把完整的路径（包括 .exe）填进去。
• macOS/Linux用户：在终端里运行 which arduino-cli 确认一下它的位置，然后填到设置里。如果是手动下载的，别忘了运行 chmod +x 给它执行权限，不然会被拒绝访问。
• 填完这些，必须重启VSCode，不然设置不会生效。怎么确认成功？按 Ctrl+Shift+P，输入 Arduino: Board Config，能弹出一个板型列表就算成功了。

板型ID和串口号，得跟手里的硬件严丝合缝

如果你把 "board" 写成了 "arduino:a vr:uno"，或者 "port" 写成了 "COM3"，VSCode不会报语法错误。但当你点上传时，就会毫无反应地失败，错误信息通常是 No device found on COM3 或 Board arduino:a vr:uno not found。那行红色报错看似明确，实则最坑。

• 板型ID不能自己想当然。比如，ESP32 DevKitC 的ID是 esp32:esp32:esp32，Nano Every 是 arduino:megaA VR:nona4809。注意，必须全小写，用冒号分隔，少一个字符都不行。
• 串口号也不是“看着差不多”就行。Windows上，去设备管理器里确认CH340或CP210x的驱动装好了，端口号是不是真的叫 COM3。macOS上，必须选 /dev/cu.usbmodem* 或 /dev/cu.usbserial* 这种，/dev/tty.* 的一般不能用来上传。
• 拔插开发板后，VSCode不会自动刷新串口列表——你得手动执行一下 Arduino: Select Serial Port 这个命令，重新选一次。

没装core，板型列表就是空的，或者上传失败

VSCode的插件不会自动帮你下载开发板的支持包。哪怕 arduino-cli 路径对了，版本也是最新的，你会发现选板型的时候列表是空的，或者只有A VR系列。这说明对应的core没装。

• 首先，运行 arduino-cli core update-index 更新一下索引。
• 装A VR板：arduino-cli core install arduino:a vr
• 装ESP32：arduino-cli core install esp32:esp32
• 装RP2040：arduino-cli core install raspberry-silicon:rp2040
• 装完所有core之后，必须重启VSCode，否则新安装的板型不会出现在 Arduino: Board Config 的列表里。

串口监视器乱码？问题多半不在波特率

90%的乱码问题，根儿都在“串口被占”。arduino-cli 在上传时会独占串口。如果你同时开着Arduino IDE、Putty、Serial Studio，或者另一个VSCode窗口也在用这个串口，上传就会悄悄失败。之后你再开监视器，连上的不过是个残留的空连接，看到的自然是乱码。

• 上传前，养成好习惯：把所有可能占用串口的软件都关掉。
• VSCode自带的那个串口监视器（长得像个插头图标）可靠性一般。更好的办法是用命令行来验证：macOS/Linux下运行 arduino-cli monitor -p /dev/cu.usbmodem14201 -b 9600；Windows下运行 arduino-cli monitor -p COM3 -b 9600。这样一目了然。
• 如果你是macOS 14+用户，用的还是CH340芯片，在高波特率（比如115200）下很容易丢数据。稳妥起见，降到 19200 或 9600 会更稳定。

最后，有个坑大家最容易忽略：第一次用 arduino-cli 之前，最好先运行一下 arduino-cli config init 初始化配置。不初始化的话，插件可能读不到本地配置，后续所有关于板型、库、端口的操作都可能出问题。可怕的是，它不会报错，只会表现出一副“一切正常”的样子，然后让你上传失败到怀疑人生。