需配置VSCode、安装Arduino CLI与PlatformIO扩展、创建Arduino项目并连接上传。具体包括：安装VSCode和arduino-cli并初始化配置；安装PlatformIO IDE扩展；新建Atmel AVR平台的Arduino Uno项目；连接硬件后配置串口端口并上传代码。

如果您希望使用 Visual Studio Code 进行 Arduino 开发，以实现物联网设备控制或嵌入式系统编程，则需完成编辑器配置、扩展安装与开发环境搭建。以下是完成该目标的具体步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装 VSCode 与 Arduino CLI

VSCode 本身不原生支持 Arduino 编译与上传，需借助 Arduino CLI 实现底层工具链集成。安装 CLI 可替代传统 Arduino IDE 的核心功能，并与 VSCode 形成轻量级协作开发流。

1、访问 https://code.visualstudio.com/ 下载并安装最新版 VSCode。

2、访问 https://github.com/arduino/arduino-cli/releases 下载对应 macOS 的 arduino-cli 压缩包。

3、解压后将 arduino-cli 可执行文件移至 /usr/local/bin/ 目录，并在终端执行 chmod +x /usr/local/bin/arduino-cli 授予执行权限。

4、在终端运行 arduino-cli config init 初始化配置文件，生成默认 arduino-cli.yaml。

二、安装 PlatformIO 扩展

PlatformIO 是 VSCode 中成熟稳定的嵌入式开发平台，内建 Arduino 框架支持、多平台编译器管理及串口监视器，无需手动配置 toolchain 或 boards.txt。

1、打开 VSCode，点击左侧活动栏的扩展图标（方块拼图形状）。

2、在搜索框中输入 PlatformIO IDE，选择官方发布的扩展（作者为 PlatformIO），点击“安装”。

3、安装完成后重启 VSCode，底部状态栏将显示 PlatformIO 图标。

4、首次启动时，PlatformIO 会自动下载核心依赖与默认开发平台（含 atmelavr），等待进度条完成。

三、配置 Arduino 开发项目

使用 PlatformIO 创建标准 Arduino 项目结构，确保符合 Arduino 核心库调用规范，并支持 .ino 文件自动识别与 setup()/loop() 入口解析。

1、点击 VSCode 左侧活动栏的 PlatformIO 图标，选择 New Project。

2、在弹出窗口中填写项目名称，平台选择 Atmel AVR，开发板选择 Arduino Uno，框架选择 Arduino。

3、点击“Finish”，PlatformIO 将自动生成包含 src/main.cpp 和 platformio.ini 的项目目录。

4、将原有 .ino 文件内容复制到 src/main.cpp 中，确保保留 #include 及标准函数签名。

四、连接硬件并上传代码

上传前需确认开发板物理连接稳定、串口设备被系统正确识别，并在项目配置中指定对应端口与上传协议，避免“port not found”或“avrdude: ser_open()”错误。

1、使用 USB 数据线将 Arduino Uno 连接至 MacBook Air，观察板载 ON 灯是否亮起。

2、在终端执行 ls /dev/tty.*，查找形如 /dev/tty.usbmodem14301 的串口设备名。

3、打开项目根目录下的 platformio.ini，在 [env:uno] 区块下添加两行：
upload_port = /dev/tty.usbmodem14301
upload_protocol = arduino。

4、点击底部状态栏的 Upload 按钮（向上箭头图标），或按 Cmd+Shift+P 输入 “PlatformIO: Upload” 并回车。

# vscode  # git  # github  # 端口  # macbook  # 工具  # usb  # mac  # ai  # macos  # 解压  # 配置文件  # for  # include  # ide  # visual studio  # visualstudio  # visual studio code  # https  # 物联网  # 嵌入式系统  # 上传  # 串口  # 并在  # 状态栏  # 开发板  # 运行环境  # 如果您  # 首次  # 自动识别  # 后将