PlatformIO在VSCode中简化嵌入式开发，依赖Python 3.7+和Git，安装扩展后可快速创建ESP32项目，通过platformio.ini配置环境，支持一键编译、上传和串口监控。
在 VSCode 中用 PlatformIO 做嵌入式开发，其实比想象中简单——它把环境搭建、库管理、编译烧录这些繁琐事全包了，你只需要专注写代码。
安装前先装好基础环境
PlatformIO 本质是 VSCode 的一个扩展，但它依赖 Python（3.7+）和 Git。别跳过这步，否则后续新建项目会报错。
- 确认已安装 Python：终端里运行 python --version 或 python3 --version，显示 3.7 以上即可
- Git 推荐装完整版（带命令行工具），PlatformIO 有时会自动 clone 库
- 打开 VSCode，搜索安装 PlatformIO IDE 扩展（官方出品，图标是蓝底白“P”）
新建一个 ESP32 项目试试手
选个常见板子练起来最直观。以 ESP32-DevKitC 为例：
- 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 PlatformIO: New Project
- 填项目名，选择开发板（搜 esp32dev），框架选 Arduino（上手快）或 ESP-IDF（更底层）
- 点创建，PlatformIO 自动初始化文件夹结构，生成 platformio.ini 配置文件
生成的 src/main.cpp 就是主程序入口，里面默认有 Arduino 风格的 setup() 和 loop()。
理解 platformio.ini 这个关键配置文件
它相当于项目的“说明书”，控制编译目标、依赖库、上传端口等。新项目生成的 ini 文件类似这样：
[env:esp32dev] platform = espressif32 board = esp32dev framework = arduino upload_port = /dev/ttyUSB0 ; Linux/Mac，Windows 是 COM3 这类 monitor_port = /dev/ttyUSB0 monitor_speed = 115200
常用改法：
- 换板子？改 board 字段（如 nodemcu-32s）
- 加库？在 lib_deps 下写一行，比如 ArduinoJson 或 https://github.com/adafruit/Adafruit_SSD1306
- 查不到串口？插好开发板后，在终端运行 pio device list 看识别到哪个端口
编译、上传、串口监控三步到位
不用切终端，VSCode 底部状态栏就有快捷操作：
- 点击左下角 Build（锤子图标）→ 编译整个项目，成功后提示 “Success”
- 点 Upload（向上箭头）→ 自动编译（如有修改）+ 烧录进板子
- 点 Serial Monitor（终端图标）→ 弹出串口监视器，波特率自动匹配 monitor_speed
如果上传失败，大概率是端口没选对、没按住 BOOT 键（某些板子需要手动进入下载模式）、或驱动没装（CH340/CP210x 芯片需单独装驱动）。
基本上就这些。PlatformIO 的优势不在多炫，而在稳定、统一、可复现——同一个 platformio.ini，换台电脑也能分分钟拉起一模一样的开发环境。
