CLion嵌入式开发必须使用arm-none-eabi-gcc交叉编译器并配置对应Toolchain和CMake参数，否则生成x86可执行文件；需手动指定编译器路径、设置CMAKE_SYSTEM_NAME=Generic等参数，并确保gdb与gcc版本一致，修改后必须Reload CMake project。
CLion 里必须用 arm-none-eabi-gcc，不能用系统 gcc
CLion 默认会找系统 PATH 里的 gcc，但嵌入式开发必须用 ARM 交叉编译器，否则生成的是 x86 可执行文件，根本烧不进单片机。关键不是“能不能编译过”，而是“编译出的东西能不能跑在 Cortex-M 上”。
常见错误现象：arm-none-eabi-gcc 命令在终端能运行，但在 CLion 里 CMake 报错说找不到编译器；或者 CMake 配置成功了，但最终生成的 .elf 文件 size 很小（比如只有几 KB），且 file firmware.elf 显示是 “ELF 64-bit LSB pie executable, x86-64”，这就彻底错了。
- 确认
arm-none-eabi-gcc已加入系统 PATH：cmd 或 PowerShell 中执行arm-none-eabi-gcc --version，有输出才代表可用 - CLion 中进入
Settings > Build, Execution, Deployment > Toolchains，点加号新增工具链，命名为 “ARM” - C Compiler 填
arm-none-eabi-gcc，C++ Compiler 填arm-none-eabi-g++，Debugger 填arm-none-eabi-gdb - 务必点击右侧文件夹图标，手动定位到你安装的工具链 bin 目录下对应可执行文件（不要依赖 PATH 自动查找，CLion 有时会缓存旧路径）
CMake Profile 必须显式指定交叉编译参数
只配 Toolchain 不够，CMake 还得知道“这不是给电脑编的”。很多项目一上来就编译出 host 可执行文件，就是因为 CMake 没被告知目标平台。
在 Settings > Build, Execution, Deployment > CMake 中，为当前项目新建一个 Profile，选中刚才创建的 “ARM” Toolchain，然后在 CMake options 栏填：
-DCMAKE_SYSTEM_NAME=Generic -DCMAKE_SYSTEM_PROCESSOR=ARM -DCMAKE_C_COMPILER=arm-none-eabi-gcc -DCMAKE_CXX_COMPILER=arm-none-eabi-g++
这几个参数缺一不可：CMAKE_SYSTEM_NAME=Generic 表示裸机环境（无 OS），CMAKE_SYSTEM_PROCESSOR=ARM 是架构标识，后两个是强制覆盖编译器路径——即使 Toolchain 已设，CMake 仍可能读取缓存或父级配置。
- 如果使用 STM32CubeMX 生成的 CMakeLists.txt，它通常自带
project(... LANGUAGES C ASM)，但不会自动加这些系统参数，必须手动补上 - 修改 CMake options 后，务必点击右上角
Reload CMake project按钮，否则改动不生效 - 若 CMake 报错
Cannot determine target architecture，基本就是漏了CMAKE_SYSTEM_PROCESSOR
编译器路径和环境变量容易互相干扰
Windows 下尤其容易踩坑：MinGW 的 gcc、WSL 的 gcc、ARM 工具链的 arm-none-eabi-gcc 全堆在 PATH 里，CLion 启动时可能加载错上下文。
典型表现：Toolchain 页面显示绿色对勾，但构建时仍调用 gcc 而非 arm-none-eabi-gcc；或者 OpenOCD 启动后 GDB 连不上，报 Remote 'g' packet reply is too long（说明 GDB 加载的是 host 符号）。
- 建议把 ARM 工具链路径（如
D:\CLion\Environment\STM32\gcc-arm-none-eabi-10.3-2021.10\bin）放在系统 PATH 的最前面 - 在 CLion 的
Help > Show Log in Explorer里打开日志，搜索compiler或toolchain，能看到它实际调用的完整路径 - 如果用了多个工具链（比如同时开发 STM32 和 ESP32），不要共用一个 Profile，每个项目单独建 Profile 并隔离 CMake options
调试器 arm-none-eabi-gdb 必须匹配编译器版本
arm-none-eabi-gdb 不是随便装一个就行。不同版本的 GCC 工具链生成的 DWARF 调试信息格式可能不兼容，GDB 版本太低会解析失败，导致断点不命中、变量显示 <optimized out> 或直接卡死。
例如用 gcc-arm-none-eabi-12.x 编译，却配了 10.x 的 gdb，就可能出现 Cannot access memory at address 0x... 类错误。
- 始终从同一份 ARM 工具链压缩包里取
arm-none-eabi-gcc和arm-none-eabi-gdb，不要混用不同来源的二进制 - 检查 GDB 版本：
arm-none-eabi-gdb --version，输出应与 GCC 小版本一致（如都是 12.2） - CLion 的 Debugger 设置里，不要勾选
Use external console，嵌入式调试必须走 GDB server + OpenOCD 管道
