VSCode for Arduino: 嵌入式开发的简易之道

可在 VSCode 中通过三种方式配置 Arduino 开发环境：一、安装 PlatformIO IDE 扩展实现开箱即用；二、配合 Arduino CLI 官方工具与 Microsoft 的 Arduino 插件直连原生环境；三、使用 CMake 工具链手动定制编译流程。

如果您希望在 Visual Studio Code 中进行 Arduino 嵌入式开发，但尚未配置好编译与上传环境，则可能是由于缺少必要的扩展、工具链或板级支持包。以下是实现该目标的具体操作路径：

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

一、安装 PlatformIO IDE 扩展

PlatformIO IDE 是 VSCode 中最成熟的嵌入式开发框架，它内置了跨平台工具链、库管理器和项目生成器，可替代 Arduino IDE 的全部核心功能，且无需手动配置 avr-gcc 或 arduino-cli。

1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。

2、在搜索框中输入 PlatformIO IDE，找到由 PlatformIO 开发团队发布的官方扩展。

3、点击“安装”，等待扩展下载并自动启用。

4、重启 VSCode，确保底部状态栏出现 PlatformIO 图标。

二、使用 Arduino CLI 插件直连 Arduino 环境

Arduino CLI 是 Arduino 官方提供的命令行工具，支持通过 VSCode 的任务系统调用编译与上传指令，适用于熟悉原生 Arduino 工具链的用户。

1、访问 https://arduino.github.io/arduino-cli/latest/installation/，下载对应 macOS 的 Arduino CLI 二进制包。

2、解压后将 arduino-cli 可执行文件移至 /usr/local/bin 目录，并赋予执行权限：chmod +x /usr/local/bin/arduino-cli。

3、在终端中运行 arduino-cli config init 初始化配置文件。

4、在 VSCode 中安装扩展 Arduino（由 Microsoft 提供），启用后即可识别 .ino 文件并调用 CLI。

三、手动配置 CMake 工具链（适用于高级定制需求）

当需要深度控制编译参数、集成第三方 RTOS 或自定义启动流程时，可通过 CMakeLists.txt 显式声明 Arduino Core 路径与目标 MCU，绕过 PlatformIO 抽象层。

1、在项目根目录创建 CMakeLists.txt，写入最低要求配置，包括 set(CMAKE_SYSTEM_NAME Arduino) 和 set(ARDUINO_CORE_PATH "/Users/xxx/Library/Arduino15/packages/arduino/hardware/avr/1.8.6")。

2、安装 CMake Tools 扩展，并在 VSCode 设置中指定 cmake.configureArgs 包含 -DARDUINO_SKETCH=main.ino。

3、打开命令面板（Cmd+Shift+P），选择 CMake: Configure，触发工具链识别。

4、构建前需确保 arduino-cli core install arduino:avr 已执行完毕，以提供完整头文件与链接脚本。