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 文件类似这样：
睿拓智能网站系统-网上商城
下载
睿拓智能网站系统-网上商城1.0免费版软件大小:5M运行环境：asp+access本版本是永州睿拓信息专为电子商务入门级用户开发的网上电子商城系统，拥有产品发布，新闻发布，在线下单等全部功能，并且正式商用用户可在线提供多个模板更换，可实现一般网店交易所有功能，是中小企业和个人开展个人独立电子商务商城最佳的选择，以下为详细功能介绍：1.最新产品-提供最新产品发布管理修改，和最新产品订单查看2.推荐产
[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，换台电脑也能分分钟拉起一模一样的开发环境。
