需安装VSCode、Arduino CLI及官方Arduino扩展,配置板卡与端口后上传Blink示例验证;macOS下用brew安装CLI,通过命令面板初始化项目、选择板型、检测端口,并确保状态栏显示正确板卡和端口信息。

如果您希望在 Visual Studio Code 中进行 Arduino 或物联网设备的开发,但尚未安装必要组件或配置开发环境,则可能是由于缺少平台支持、扩展插件或工具链路径未正确设置。以下是完成此配置的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 VSCode 与 Arduino CLI
VSCode 本身不原生支持 Arduino 编译,需借助 Arduino CLI 提供命令行构建能力,并通过扩展调用。安装 CLI 可避免依赖 Arduino IDE 图形界面,提升自动化与跨平台一致性。
1、访问 https://code.visualstudio.com/Download 下载并安装最新版 VSCode。
2、打开终端,执行 brew install arduino-cli 安装 Arduino CLI(macOS 用户)。
3、运行 arduino-cli config init 生成默认配置文件,确认板卡支持索引已初始化。
二、安装核心扩展插件
VSCode 需通过官方认证扩展识别 .ino 文件、提供语法高亮、自动补全及上传功能。必须安装由 Arduino 官方维护的扩展以确保兼容性与更新及时性。
1、启动 VSCode,点击左侧活动栏的扩展图标(或按 Cmd+Shift+X)。
2、在搜索框中输入 Arduino,找到名称为 Arduino by Microsoft 的扩展(发布者为 Microsoft),点击安装。
3、安装完成后,重启 VSCode 使插件完全激活。
三、配置 Arduino 板卡与端口
插件需明确知道目标硬件型号及连接串口,否则无法编译或上传代码。该步骤将注册开发板定义并检测物理连接状态。
1、在 VSCode 中按下 Cmd+Shift+P,输入 Arduino: Initialize 并回车,选择项目目录创建 .vscode/arduino.json。
2、再次调出命令面板,输入 Arduino: Board Config,从列表中选择 Arduino Uno(或其他实际使用的板型)。
3、执行 Arduino: Detect Boards,确认 USB 设备已接入且端口如 /dev/cu.usbmodem14301 显示为可用。
四、验证开发流程
通过编译并上传一个基础示例程序,可验证所有组件是否协同工作。此步骤直接反映配置是否成功,无需额外调试工具介入。
1、执行 Arduino: Examples 命令,选择 01.Basics/Blink 示例并打开。
2、检查右下角状态栏是否显示当前板卡型号与端口号,若为灰色或空缺,请返回第三步重新检测。
3、按下 Cmd+Shift+P,输入 Arduino: Upload 并执行,观察终端输出是否出现 Sketch uploaded successfully。










