VSCode for Arduino/PlatformIO开发入门_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

VSCode for Arduino/PlatformIO开发入门

2025-12-15

浏览次数：次

返回列表

用VSCode搭建Arduino/PlatformIO开发环境更灵活强大，需安装VSCode、PlatformIO IDE和C/C++插件，创建项目后配置platformio.ini，支持多环境编译、上传与串口监控。

用 vscode 搭建 arduino 或 platformio 开发环境，比 arduino ide 更灵活、更强大，尤其适合中大型项目或需要代码管理、调试、多平台编译的场景。核心是装对插件、配好工具链、理解 platformio 的项目结构。

安装 VSCode 和必要插件

从官网下载并安装最新版 VSCode（code.visualstudio.com）。打开后，在扩展市场（Ctrl+Shift+X）搜索并安装：

PlatformIO IDE：官方插件，提供项目创建、编译、上传、串口监视、库管理等完整功能（自动提示安装 Python 和 PlatformIO Core）
C/C++（Microsoft 官方）：提供语法高亮、智能补全、跳转定义等基础语言支持
Arduino（optional）：仅当你仍需偶尔用原生 Arduino 库或 .ino 文件时可选装；PlatformIO 本身已兼容大部分 Arduino API，不强制依赖此插件

创建第一个 PlatformIO 项目

按 Ctrl+Shift+P 打开命令面板，输入 PlatformIO: New Project，回车后按提示操作：

选择项目名称和保存路径（建议放在无中文、无空格的目录下）
选择开发板（如 Arduino Uno、ESP32 DevKitC 等，支持自动识别常用型号）
选择框架（默认 Arduino 即可；也可选 ESP-IDF、ARM mbed 等）

完成后，VSCode 会自动生成标准 PlatformIO 项目结构：src/（主代码）、lib/（本地库）、platformio.ini（构建配置文件）。入口文件默认为 src/main.cpp，内容与 Arduino 的 setup()/loop() 一致。

理解 platformio.ini 配置文件

这是 PlatformIO 项目的“大脑”，控制编译目标、库依赖、上传参数等。一个典型配置示例如下：

AI Code Reviewer

AI自动审核代码

112 查看详情 AI Code Reviewer

[env:uno]
platform = atmel*r
board = uno
framework = arduino

[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200

每个 [env:xxx] 是一个独立环境，可同时定义多个（如 Uno + ESP32），用 PlatformIO: Build Environment 切换。常用字段：

platform：指定芯片平台（atmel*r、espressif32、ststm32 等）
board：开发板型号，PlatformIO 内置数百种，可查 platformio.org/boards
framework：开发框架（arduino 最常用；cmsis、zephyr 等适合底层开发）
monitor_speed：串口监视器波特率
lib_deps：声明外部库（如 lib_deps = Adafruit SSD1306, OneWire），PlatformIO 自动下载安装

编译、上传与串口监控

所有操作均可通过左侧 PlatformIO 工具栏（闪电图标）或命令面板触发：

Build（编译）：点击 Build 按钮或运行 PlatformIO: Build，生成固件（.hex/.bin）
Upload（上传）：确保开发板已连接且驱动正常（Windows 可能需手动装 CH340/CP210x 驱动），点击 Upload 按钮；若端口未识别，可在 platformio.ini 中加 upload_port = /dev/ttyUSB0（Linux/macOS）或 upload_port = COM3（Windows）
Monitor（串口监视）：点击 Monitor 按钮，打开内置串口终端；支持发送数据、切换行尾符、调整波特率（需与代码中 Serial.begin(115200) 一致）