直接安装microsoft发布的arduino扩展(橙色∞图标),重启vs code后验证左下角arduino图标、右下角板/端口选择器及arduino:命令是否可用;必须同步安装microsoft官方c/c++插件以支持intellisense。

直接搜“Arduino”装官方扩展就行
VS Code 安装 Arduino 扩展没有歧义路径,认准 Microsoft 发布的 Arduino 扩展(图标是橙色 ∞ + “Arduino” 字样),其他同名插件基本是旧版、弃更或功能残缺的。装错会导致后续板子识别失败、Arduino: Board Manager 命令不可用、甚至根本看不到右下角的开发板/端口选择器。
安装后必须重启 VS Code 或重载窗口
扩展安装界面会提示“启用”或“重新加载”,但实测中仅点击“启用”往往不够——Arduino 扩展依赖底层语言服务初始化,不重启或重载(Ctrl+Shift+P → 输入 Developer: Reload Window)会导致命令面板里搜不到 Arduino: Select Board,或者左下角始终不显示 Arduino 图标。
装完立刻验证是否生效
打开一个空文件夹,新建一个 test.ino 文件并保存。如果扩展正常工作,你会看到:
- 左下角出现 Arduino 图标(带电路板轮廓)
- 右下角可点击选择开发板型号(如 Arduino Uno)和串口(如 /dev/cu.usbmodem14201 或 COM3)
- 按 Ctrl+Shift+P 能搜到至少 5 个以 Arduino: 开头的命令(比如 Arduino: Upload、Arduino: Verify)
如果以上任一缺失,大概率是没重启,或扩展被其他 C/C++ 插件冲突屏蔽了(这时先禁用非必要插件再试)。
别跳过 C/C++ 插件这个依赖项
Arduino 扩展本身不提供语法高亮和跳转定义能力,它靠 C/C++ 插件(Microsoft 出品)驱动 IntelliSense。没装这个,写 digitalWrite(LED_BUILTIN, HIGH) 时不会提示 LED_BUILTIN 定义位置,编译错误也不标红。装法一样:扩展面板搜 C/C++,认准发布者是 Microsoft,装完不用额外配置,只要 test.ino 文件处于打开状态即可触发索引。
Arduino CLI 路径问题通常不在安装阶段暴露,而是首次调用 Arduino: Board Manager 时才报错,那属于下一步配置环节——先确保扩展装对、能响应,再处理工具链路径。











