VSCode写Arduino需装Arduino和C/C++两个核心插件；PlatformIO适合进阶但新手易混淆；调试仅支持Serial打印，真断点需换ESP32/STM32板。
VSCode 装什么插件才能写 Arduino 代码
VSCode 本身不支持 Arduino 编译和烧录，必须靠插件补全工具链。核心插件只有两个：Arduino（由 Microsoft 官方维护）和 C/C++（提供语法高亮、跳转、智能提示）。PlatformIO IDE 是另一条路，但对纯 Arduino 新手反而容易混淆——它抽象了板卡配置和库管理，调试时看不到底层 platform.txt 或 boards.txt 的实际作用。
实操建议：
- 卸载所有其他 Arduino 相关插件（比如
Arduino Snippets、Arduino Code Runner），避免命令冲突 - 安装
Arduino插件后，重启 VSCode，它会自动检测系统中是否已安装arduino-cli；没装就按提示下载并初始化（路径别含中文或空格） - 确保你的 Arduino IDE 1.6.12+ 已安装（插件默认优先复用其内置工具链），或手动配置
arduino.path指向arduino.exe所在目录
怎么让 VSCode 正确识别开发板和串口
常见现象是点击“上传”后报错：Board arduino:avr:uno is not valid，或串口列表为空。根本原因不是硬件没连，而是 VSCode 没读到板卡定义或 USB 转串芯片驱动没生效。
实操建议：
- 先用 Arduino IDE 打开一个空草稿，选择菜单
工具 → 开发板 → Arduino Uno和端口 → COM3 (Arduino Uno)，成功上传一次——这一步会触发驱动安装和板卡索引注册 - 在 VSCode 中按
Ctrl+Shift+P输入Arduino: Board Config，选中对应板型；再运行Arduino: Select Serial Port，手动刷新或输入 COM 口名（如COM4） - Windows 下若仍看不到串口，检查设备管理器里是否有黄色感叹号的
USB-SERIAL CH340或CP210x，去官网下最新驱动；Mac 上注意/dev/cu.usbserial-才可用，/dev/tty.usbserial-通常只读
如何调试 Arduino 程序（不是只看 Serial.print）
VSCode 的 Arduino 插件原生不支持断点调试（因为 AVR 架构缺乏标准 JTAG/SWD 支持，且 Arduino Core 抽象层屏蔽了底层寄存器访问）。真要调试，得换硬件和方式：
实操建议：
- 普通 Uno/Nano：只能靠
Serial.print()+delay()配合逻辑分析，把关键变量周期性打出来；注意别在中断服务函数里用Serial.print()，会卡死 - 想单步执行？换用支持调试的开发板，比如
ESP32 DevKitC（用 PlatformIO + OpenOCD）或STM32 Nucleo（配合 ST-Link 和 Cortex-Debug 插件） - 如果坚持用 AVR，可导出编译后的
.elf文件（开启arduino.logLevel为debug查看构建路径），用avr-gdb+simulavr做仿真调试，但学习成本远超入门需求
常见编译失败错误及快速定位方法
报错信息常被一大段编译日志淹没，真正有用的线索往往在最后三行。例如：
exit status 1 'LED_BUILTIN' was not declared in this scope Error compiling for board Arduino Uno.
这类错误不是环境问题，而是代码/库不匹配。重点盯住 was not declared、no matching function、undefined reference to 这三类提示。
实操建议：
-
'XXX' was not declared：检查是否漏了#define或拼错引脚名（如把LED_BUILTIN写成LED_BUILT_IN）；Uno 板上没有LED_BUILTIN定义？加一行#define LED_BUILTIN 13 -
no matching function：多出现在用了新版本库函数但旧版 Core 不支持，比如analogReadResolution(12)在 AVR 板上无效——AVR 只支持 10 位，删掉这行或改用analogRead() -
undefined reference to 'xxx'：函数声明了没定义，或 .cpp 文件没加入项目（VSCode 默认只编译 .ino，.cpp 需手动在arduino.additionalUrls或sketch.ino.cpp中显式引用）
硬件编程的麻烦不在语法，而在每块板子的寄存器映射、时钟树配置、Bootloader 版本都不同。哪怕同一行 digitalWrite(13, HIGH)，在 Uno、Leonardo、ESP32 上走的底层路径完全不同——别指望一个设置通吃所有板子。
