VS Code需配合Arduino官方扩展和arduino-cli才能完成Arduino开发全流程。必须手动安装配置arduino-cli、初始化配置、正确选择板型与串口，并排查驱动及连接问题。
VS Code 本身不原生支持 Arduino 开发，必须通过 Arduino Extension（由 Microsoft 官方维护）+ arduino-cli 底层工具链才能完成编写、验证、上传全流程。直接装插件不配 CLI，会卡在“找不到端口”或“Verify failed: no board selected”这类错误。
安装 arduino-cli 并让 VS Code 找到它
VS Code 的 Arduino 插件默认依赖系统 PATH 中的 arduino-cli 可执行文件，不是图形 IDE 那套后台服务。Windows/macOS/Linux 都要手动下载并配置路径。
- 去 GitHub releases 页面 下载对应系统的
arduino-cli（如arduino-cli_0.38.2_Windows_64bit.zip），解压后把arduino-cli.exe（或 macOS/Linux 的可执行文件）所在目录加进系统 PATH - 终端运行
arduino-cli version能输出版本号才算成功；否则 VS Code 插件会提示 “arduino-clinot found” - 首次运行需初始化：
arduino-cli config init，它会生成arduino-cli.yaml，之后插件才能读取板卡和库配置
用 Arduino 插件新建项目并选择正确板型
插件创建的项目结构和传统 Arduino IDE 不同：它生成的是带 platformio.ini 或 arduino.json 的纯代码目录，没有隐藏的临时构建文件夹。选错板型会导致编译失败或上传后无响应。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入 “Arduino: Initialize” 创建新项目 - 在弹出的板型列表中，不要只搜关键词如 “uno” —— 实际要选完整标识，例如
Arduino Uno对应arduino:avr:uno，而Arduino Nano Every是arduino:megaavr:nona4809 - 如果列表里没有你的开发板（比如 ESP32 或 RP2040），先在终端运行
arduino-cli core install esp32:esp32或arduino-cli core install raspberry-silicon:rp2040，再重开 VS Code
上传前必须手动选择串口和端口速度
不像 Arduino IDE 自动枚举 COM/USB 设备，VS Code 插件默认不自动刷新串口列表，拔插设备后需手动触发，否则上传时显示 “No serial port available” 或上传成功但板子没反应。
- 连接开发板后，按
Ctrl+Shift+P输入 “Arduino: Select Serial Port”，从下拉菜单选对的端口（Windows 是COM3，macOS 是/dev/cu.usbserial-XXXX，Linux 是/dev/ttyUSB0） - 某些板子（如 CH340 芯片的 Nano 兼容版）需要额外设置上传速率：在项目根目录建
arduino.json，写入{"upload": {"speed": 115200}} - 上传命令是
Ctrl+Shift+P→ “Arduino: Upload”，不是 Ctrl+S 保存就自动上传 —— 这点新手最容易误以为“写完就能跑”
常见上传失败原因和快速排查项
报错信息往往藏在 VS Code 右下角通知或输出面板（Output → Arduino）里，而不是终端窗口。很多问题其实和代码无关，而是环境链路断了。
-
Failed to execute script arduino-cli：PATH 没配好，或arduino-cli权限不足（macOS/Linux 需chmod +x） -
Board arduino:avr:uno not found：core 没装全，运行arduino-cli core list看是否含 avr，没有就arduino-cli core update && arduino-cli core install arduino:avr - 上传时进度条卡住几秒后失败：USB 驱动异常（尤其 Windows 上 CH340 需重装驱动）、USB 线仅充电不传数据、板子未进入 bootloader 模式（Nano 类需手动按复位键时机配合上传）
- 上传成功但 LED 不闪：检查
void setup()里是否漏了pinMode(LED_BUILTIN, OUTPUT)，或LED_BUILTIN定义不匹配（某些兼容板需改成13）
真正麻烦的从来不是写代码，而是让 VS Code、arduino-cli、驱动、物理连接这四层之间不互相“假装在线”。每次换电脑或换线，都建议从 arduino-cli version 和 arduino-cli board list 这两个命令开始验证。
