用途：PlatformIO 是面向嵌入式开发的跨平台工具链，本资料汇总其安装、项目配置、构建上传、测试调试与依赖管理的完整参考，覆盖 Arduino、ESP-IDF、STM32、RP2040、AVR、ESP8266 等平台与框架。
主要能力与用法：
- 安装：可使用 pip install platformio，或运行官方安装脚本 get-platformio.py。
- 项目结构：platformio.ini 为配置入口，src/ 放源码，include/ 放头文件，lib/ 放项目库，test/ 放单元测试，.pio/ 为构建输出。
- 配置：在 platformio.ini 中按 [env:名称] 定义环境，设置 platform、board、framework；资料给出 ESP32、ESP32-S3（含 PSRAM）、ESP-IDF 分区表、Nucleo F446RE、Blue Pill、Pico、Pico W 等示例配置。
- 常用命令：pio run 构建，pio run -t upload 上传（可指定 --upload-port），pio device monitor 串口监视（支持 -b 波特率、--filter esp32_exception_decoder），pio test 运行测试，pio device list、pio boards 查询设备与开发板，pio pkg search/install/list/update 管理库。
- 依赖与构建标志：lib_deps 支持 owner/name、GitHub 仓库、分支与本地路径以及版本约束（@1.2.3、@^1.2.3、@~1.2.3、@>=1.0.0）；build_flags 支持宏定义、包含路径、优化与警告选项。
- 多环境与继承：可用 [env] 共享配置，未用 extends 复用基础环境，也可按 debug/release 覆盖 build_type 与 flags；extra_scripts 支持 pre/post 构建自定义脚本。
- 测试与调试：内置 Unity 框架，可进行 native 平台测试与设备端测试；调试可配置 debug_tool（如 esp-prog）并使用 pio debug 启动，资源提及 GDB 接口方式。
适用场景与限制：适合需要统一管理多开发板、多框架的嵌入式项目与自动化构建测试流程。资料未提供收费、价格、平台支持范围之外的功能或具体效果说明；部分命令参数细节与脚本 API 请以实际版本为准。