VSCode 配合 PlatformIO 插件可替代 Arduino IDE 实现高效嵌入式开发:依次安装 VSCode 与 PlatformIO 插件、创建项目、配置串口上传参数、编写上传固件代码、启用串口监视器调试。

如果您希望在现代代码编辑器中高效开发 Arduino 或其他嵌入式固件,VSCode 配合 PlatformIO 插件可替代传统 Arduino IDE,提供更灵活的项目管理、调试支持与多平台编译能力。以下是实现该开发流程的具体操作路径:
本文运行环境:MacBook Pro,macOS Sequoia。
一、安装 VSCode 与 PlatformIO 插件
PlatformIO 是一个开源的嵌入式开发生态系统,其 VSCode 扩展提供了完整的工具链集成,包括编译、上传、串口监视与单元测试功能。
1、访问 code.visualstudio.com 下载并安装最新版 VSCode。
2、启动 VSCode,在左侧扩展面板中搜索 PlatformIO IDE,点击“安装”按钮完成插件部署。
3、重启 VSCode,等待底部状态栏出现 PlatformIO 图标且无报错提示。
二、创建 PlatformIO 项目
通过 PlatformIO 初始化项目可自动生成符合标准结构的工程目录,包含平台定义、库依赖管理及构建配置文件。
1、点击左侧活动栏中的 PlatformIO 图标,选择“New Project”。
2、在弹出窗口中输入项目名称,例如 led_blink。
3、从下拉菜单中选择目标开发板,如 Arduino Uno,平台选为 atmelavr。
4、确认项目路径后点击“Finish”,等待初始化完成并自动打开项目文件夹。
三、配置串口上传参数
上传固件前需明确指定连接设备的串行端口与上传协议,避免因端口未识别或权限不足导致烧录失败。
1、将 Arduino 开发板通过 USB 线接入电脑,打开终端执行 ls /dev/tty.* 查看可用端口(macOS)。
2、在项目根目录下的 platformio.ini 文件中添加或修改 upload_port 行,值设为实际端口,例如 /dev/tty.usbmodem14301。
3、确保 upload_protocol 设置为 arduino,以兼容标准 Bootloader。
四、编写与上传固件代码
PlatformIO 默认使用 C++ 编写固件,主程序入口为 src/main.cpp,其结构与 Arduino IDE 兼容但支持更严格的语法检查与模块化组织。
1、在 src 文件夹内双击打开 main.cpp。
2、删除默认模板内容,粘贴标准 Arduino 风格代码,例如包含 setup() 与 loop() 函数的 LED 闪烁逻辑。
3、点击左下角 PlatformIO 图标,在“Quick Access”区域点击 Upload 按钮触发编译与烧录流程。
五、启用串口监视器调试
PlatformIO 内置串口监视器可实时捕获设备输出,支持自定义波特率、换行符格式与编码方式,便于验证传感器数据或调试日志。
1、点击左下角 PlatformIO 图标,在“Quick Access”中选择 Serial Monitor。
2、在弹出终端窗口右上角点击齿轮图标,将 Baud Rate 修改为与代码中 Serial.begin(9600) 一致的数值。
3、确保 Line ending 设置为 Both NL & CR,以便正确解析回车换行指令。










