第四篇：交叉编译与工具链文件——一套代码，多个平台
📌 前言
前几篇文章我们写了CMakeLists.txt，但里面有一些硬编码的内容：
arm-none-eabi-gcc（编译器名称）-mcpu=cortex-m3（CPU 型号）stm32f103.ld（链接脚本）
如果换一个芯片（比如从 STM32F103 换到 STM32F407），这些内容都要改。有没有办法让 CMakeLists.txt 完全不用动，只改一个文件就能切换芯片呢？
答案是：工具链文件（Toolchain File）。
🧠 一、什么是交叉编译？
在继续之前，先理解一个概念：交叉编译。
本地编译：在 PC 上编译，在 PC 上运行（比如你用 VS Code 写了一个 Hello World，在电脑上运行）
交叉编译：在 PC 上编译，在另一个平台上运行（比如在 PC 上编译出单片机可以运行的机器码）
单片机开发就是典型的交叉编译。我们需要告诉 CMake：
编译器不是系统的
gcc，而是arm-none-eabi-gcc目标系统不是 Windows/Linux，而是裸机
编译选项要根据芯片型号来定
这些信息，都可以放在工具链文件里。
📝 二、工具链文件长什么样？
工具链文件本质上就是一个 CMake 脚本，里面set()了一系列变量。
cmake/arm-none-eabi-gcc.cmake：
# ============================================================ # 工具链文件：ARM GCC 交叉编译配置 # ============================================================ # 1. 目标系统 set(CMAKE_SYSTEM_NAME Generic) set(CMAKE_SYSTEM_PROCESSOR arm) # 2. 编译器 set(CMAKE_C_COMPILER arm-none-eabi-gcc) set(CMAKE_CXX_COMPILER arm-none-eabi-g++) set(CMAKE_ASM_COMPILER arm-none-eabi-gcc) # 3. 编译选项（可由用户覆盖） set(MCU_FLAGS "-mcpu=cortex-m3 -mthumb") set(CMAKE_C_FLAGS "${MCU_FLAGS} -Wall -Wextra -std=c11" CACHE STRING "" FORCE) set(CMAKE_CXX_FLAGS "${MCU_FLAGS} -Wall -Wextra -std=c++14" CACHE STRING "" FORCE) set(CMAKE_ASM_FLAGS "${MCU_FLAGS}" CACHE STRING "" FORCE) set(CMAKE_EXE_LINKER_FLAGS "${MCU_FLAGS} -T ${CMAKE_SOURCE_DIR}/stm32f103.ld" CACHE STRING "" FORCE) # 4. 调试信息 set(CMAKE_C_FLAGS_DEBUG "-O0 -g3" CACHE STRING "" FORCE) set(CMAKE_C_FLAGS_RELEASE "-Os" CACHE STRING "" FORCE)注意CACHE STRING "" FORCE的写法，它让这些变量可以被用户在命令行覆盖。
🚀 三、如何使用工具链文件？
使用工具链文件非常简单，在cmake配置时通过-DCMAKE_TOOLCHAIN_FILE参数指定：
cmake -B build -DCMAKE_TOOLCHAIN_FILE=cmake/arm-none-eabi-gcc.cmake cmake --build build如果你的工程支持多个芯片平台，可以准备多个工具链文件：
cmake/ ├── arm-none-eabi-gcc-stm32f1.cmake # STM32F1 ├── arm-none-eabi-gcc-stm32f4.cmake # STM32F4 ├── arm-none-eabi-gcc-stm32l4.cmake # STM32L4 └── esp32.cmake # ESP32切换芯片，只需要换一个工具链文件。CMakeLists.txt 完全不用动。
🔄 四、实战：同一份代码编译到不同芯片
4.1 项目结构
my_firmware/ ├── CMakeLists.txt # 一份！完全不用动 ├── cmake/ │ ├── stm32f103.cmake # STM32F103 工具链 │ └── stm32f407.cmake # STM32F407 工具链 ├── src/ │ └── main.c # 一份！完全不用动 └── ld/ ├── stm32f103.ld # F103 链接脚本 └── stm32f407.ld # F407 链接脚本4.2 CMakeLists.txt（不再包含硬件相关的硬编码）
cmake_minimum_required(VERSION 3.20) project(MyFirmware C ASM) # 编译选项和链接脚本都在工具链文件中定义 # CMakeLists.txt 只关注“有哪些源文件” add_executable(my_firmware src/main.c src/system.c ) target_include_directories(my_firmware PRIVATE inc/ drivers/inc/ )4.3 编译到 STM32F103
cmake -B build_f103 -DCMAKE_TOOLCHAIN_FILE=cmake/stm32f103.cmake cmake --build build_f1034.4 编译到 STM32F407
cmake -B build_f407 -DCMAKE_TOOLCHAIN_FILE=cmake/stm32f407.cmake cmake --build build_f407同一份代码，同一个 CMakeLists.txt，两个不同的芯片，两套独立的编译产物。
⚙️ 五、CMake Presets：更优雅的切换方式
如果你的项目支持多个平台，每次都要输入长长的命令有点麻烦。CMake 3.19+ 支持CMake Presets，可以把配置写在CMakePresets.json里。
CMakePresets.json：
{ "version": 3, "configurePresets": [ { "name": "stm32f103", "displayName": "STM32F103", "generator": "Ninja", "binaryDir": "${sourceDir}/build_f103", "cacheVariables": { "CMAKE_TOOLCHAIN_FILE": "${sourceDir}/cmake/stm32f103.cmake" } }, { "name": "stm32f407", "displayName": "STM32F407", "generator": "Ninja", "binaryDir": "${sourceDir}/build_f407", "cacheVariables": { "CMAKE_TOOLCHAIN_FILE": "${sourceDir}/cmake/stm32f407.cmake" } } ] }之后只需要：
cmake --preset stm32f103 cmake --build build_f103📝 六、总结
工具链文件的核心价值：把“硬件相关”的配置从 CMakeLists.txt 中抽离出来。
| 放在 CMakeLists.txt 中 | 放在工具链文件中 |
|---|---|
| 项目名称 | 编译器路径 |
| 源文件列表 | CPU 型号 |
| 头文件路径 | 编译选项 |
| 模块依赖 | 链接脚本 |
这样做的好处：
CMakeLists.txt 只关注“代码组织”，不关注“硬件差异”
换芯片 = 换工具链文件，业务代码完全不动
同一份代码，可以在 CI 中并行编译到多个平台