对比CMake 和 PlatformIO 构建嵌入式项目方式

最新推荐文章于 2025-07-05 06:54:13 发布

is0815

最新推荐文章于 2025-07-05 06:54:13 发布

阅读量604

点赞数 5

CC 4.0 BY-SA版权

文章标签： stm32

下面是 CMake 和 PlatformIO 构建项目方式的详细对比，从项目结构、配置方式、构建流程、适用场景、优缺点等多个维度说明它们的异同：

MyProject/
├── CMakeLists.txt
├── src/
│   └── main.cpp
├── include/
│   └── myheader.h
├── build/
└── toolchain.cmake        # 仅嵌入式用

MyPIOProject/
├── platformio.ini
├── src/
│   └── main.cpp
├── include/
│   └── myheader.h
├── lib/
│   └── custom_lib/
├── .pio/
└── .vscode/

对比项	CMake	PlatformIO
配置文件	`CMakeLists.txt`（脚本语言）	`platformio.ini`（INI格式）
工具链设置	手动指定 `toolchain.cmake` 或环境变量	自动内置并识别开发板对应工具链
添加源文件	`file(GLOB ...)` 或手动列表	默认编译 `src/` 下所有文件
添加库	`target_link_libraries()` 等	`lib_deps` 或 `lib/` 目录自动加载
串口烧录/上传	需自写脚本/调用外部工具	内置烧录逻辑，支持 `upload` 命令
调试支持	需自建 GDB + OpenOCD 环境	自带调试器支持（取决于开发板）
支持平台	全平台，包括 Linux/Windows/macOS/嵌入式	主要为嵌入式（ESP32、STM32、Arduino 等）

操作	CMake 命令	PlatformIO 命令
配置项目	`cmake ..`	自动完成，无需额外配置
编译项目	`cmake --build .` 或 `make`	`platformio run`
上传固件	❌ 需手动调用工具（如 `esptool.py`）	✅ `platformio run --target upload`
打开串口监视	❌ 手动打开 `minicom` / `screen`	✅ `platformio device monitor`
添加库	自己下载、解压、link	自动通过库管理器

特性	CMake	PlatformIO
官方库支持	❌ 无内建库管理	✅ 内建数千个库
添加外部库	通过 `FetchContent` 或 `add_subdirectory`	`lib_deps = 库名`
私有库	手动管理（如 Git 子模块）	放入 `lib/` 或通过 Git/URL 安装

mkdir build
cd build
cmake ..
make
./MyProject   # 如果是桌面程序

platformio run                # 构建
platformio run --target upload  # 编译+上传到开发板
platformio device monitor     # 串口调试

工具	优点	缺点
CMake	灵活强大，通用于任何项目类型；支持复杂构建逻辑；跨平台	上手略难，嵌入式使用需手动设置工具链和上传流程
PlatformIO	快速上手；一键构建上传调试；内建库管理器；支持 VSCode 插件	较封闭，不适合非嵌入式项目；某些定制构建流程不如 CMake 灵活