
PlatformIO 是一個跨平臺的嵌入式開發工具鏈,支持超過 50 種開發平臺和 2000 多個開發板。
官方資源鏈接(復制到瀏覽器打開):
https://docs.platformio.org/en/latest/what-is-platformio.html
它集成了構建系統、庫管理、調試工具和持續集成等功能,為嵌入式開發者提供了高效的一站式解決方案。

# 使用 Python pip 安裝
python3 -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
安裝完成后,PlatformIO 會自動下載必要的工具鏈。首次啟動可能需要一些時間,因為它會:
典型的 PlatformIO 項目結構如下:
my_project/
├── include/ # 頭文件目錄
├── lib/ # 本地庫目錄
├── src/ # 源代碼目錄
│ └── main.cpp # 主程序文件
├── test/ # 測試代碼目錄
├── platformio.ini # 項目配置文件
└── .pio/ # PlatformIO 生成的文件(自動創建)
platformio.ini 是 PlatformIO 項目的核心配置文件,示例:
[env:uno]
platform = atmelavr
board = uno
framework = arduino
monitor_speed = 9600
lib_deps =
adafruit/Adafruit NeoPixel@^1.7.0
bblanchon/ArduinoJson@^6.18.5
常用配置選項:
platform: 硬件平臺(如 atmelavr、espressif32 等)board: 具體開發板型號framework: 使用的框架(arduino、espidf 等)monitor_speed: 串口監視器波特率lib_deps: 項目依賴的庫build_flags: 編譯選項upload_port: 上傳端口debug_tool: 調試工具配置pio run構建過程中會顯示詳細的編譯信息,包括:
pio run --target upload上傳前確保:
pio device monitor常用串口監視器命令:
Ctrl+T Ctrl+H - 顯示幫助Ctrl+T Ctrl+X - 重置終端Ctrl+T Ctrl+Q - 退出PlatformIO 提供了強大的庫管理功能:
pio lib search "sensor"
pio lib install 12 # 通過ID安裝
pio lib install "Adafruit NeoPixel" # 通過名稱安裝
pio lib update
在 platformio.ini 中可指定庫版本:
lib_deps =
adafruit/Adafruit NeoPixel@^1.7.0
# 或精確版本
bblanchon/ArduinoJson@6.18.5
版本說明符:
^1.2.3 - 兼容版本(允許次版本和修訂號更新)~1.2.3 - 近似版本(只允許修訂號更新)1.2.3 - 精確版本PlatformIO 支持在單個項目中配置多個環境:
[env:uno]
platform = atmelavr
board = uno
framework = arduino
[env:nodemcuv2]
platform = espressif8266
board = nodemcuv2
framework = arduino
monitor_speed = 115200
切換環境:
pio run -e nodemcuv2[env:custom_build]
platform = espressif32
board = esp32dev
framework = arduino
build_flags =
-D DEBUG_LEVEL=2
-Os
-Wall
[env:debug]
platform = ststm32
board = nucleo_f401re
framework = mbed
debug_tool = stlink
launch.json 調試配置PlatformIO 集成了單元測試框架:
test 目錄下創建測試代碼pio test -e uno
使用 PlatformIO Remote 進行遠程開發:
PlatformIO 內置 CI 支持,示例 .travis.yml:
language: python
python:
- "3.7"
install:
- pip install -U platformio
script:
- platformio run
pio lib list 查看已安裝庫pio run -t clean.pio 和 .vscode 目錄PlatformIO 是現代嵌入式開發的強大工具,它通過整合各種工具鏈和簡化開發流程,顯著提高了開發效率。雖然初期學習曲線比 Arduino IDE 陡峭,但其提供的專業功能和靈活性使其成為復雜嵌入式項目的理想選擇。
通過本指南,您應該已經掌握了 PlatformIO 的核心功能和使用方法。隨著實踐的深入,您將能夠充分利用 PlatformIO 的強大功能,開發出更加專業和高效的嵌入式應用程序。

覺得文章不錯,點擊“分享”、“贊”、“推薦” 唄!