CLion调试环境需按工具链→CMake Profile→运行/调试配置顺序协同配置：先选对工具链（如嵌入式用arm-none-eabi-gcc、Docker/WSL选对应工具链），再确保CMake Profile匹配该工具链并重载缓存，最后设置正确的远程或本地调试配置，缺一不可。
CLion 调试环境不是“设一次就完事”的静态配置，而是由工具链（Toolchain）、CMake Profile、运行/调试配置三者协同决定的。缺一不可，且顺序不能乱：先配工具链，再配 CMake Profile，最后才是运行/调试配置。
怎么选对 Toolchain（工具链）
工具链决定了 CLion 用哪个编译器、哪个 gdb、在哪执行构建和调试。Windows 上常见错误是默认用了 MinGW 却在项目里用 arm-none-eabi-gcc 编译，结果断点不命中、变量显示为 <optimized out>。
- 嵌入式开发（如 STM32、RISC-V）：必须手动添加自定义工具链，指向
arm-none-eabi-gcc所在目录，并把arm-none-eabi-gdb设为 Debugger - Docker 容器内开发：选
Docker工具链，镜像里得预装cmake和gdb，路径映射必须准确（比如宿主机D:/project→ 容器内/app） - WSL2 开发：选
WSL工具链，不要用 System 工具链去“猜” WSL 路径，CLion 会自动识别已安装的发行版 - MSVC 项目：选
Visual Studio工具链，但注意：若要用clang-cl，得手动把 Debugger 改成lldb，并启用Enable NatVis renderers for LLDB
CMake Profile 必须匹配工具链
很多人改了工具链却没改 CMake Profile，导致 CLion 还在用旧编译器生成缓存，build 目录里一堆 CMakeCache.txt 错误，甚至无法识别 add_definitions("-g")。
- 进入
Settings | Build, Execution, Deployment | CMake，新增或编辑 Profile - 务必把
Toolchain下拉框选成你刚配置好的那个，不是默认的 -
Build directory建议设为相对路径（如cmake-build-debug），避免绝对路径跨机器失效 - Generator 别硬选
MinGW Makefiles或Ninja—— 如果工具链是 Docker 或 WSL，选Let CMake decide更稳妥 - 改完点
Reload cache，别只点OK；如果 CMake 加载失败，看右下角弹出的CMake Output里的第一行错误，通常是编译器路径不对或-g没传进去
Remote Debug 配置最容易漏的关键项
远程调试（比如板端跑 gdbserver :1234 ./app，CLion 连过去）失败，90% 出在三个地方：符号没带、优化没关、端口不通。
- 确保
CMakeLists.txt里有：set(CMAKE_CXX_FLAGS_DEBUG "-g -O0")，而不是只写add_definitions("-g") -
Run | Edit Configurations | + | Remote GDB中：Host name填板端 IP（不是localhost），Port填1234（和gdbserver启动参数一致） -
Symbols path必须指向本地编译生成的未 stripped 的二进制（如cmake-build-debug/app），不是板端路径 - 如果用 OpenOCD 或 J-Link，别用
Remote GDB模板 —— 改用Embedded GDB Server，它会自动拉起openocd并下载固件
真正麻烦的从来不是“怎么点菜单”，而是工具链、CMake、调试器三者之间的符号传递是否完整。比如 Docker 里 gdb 版本太老不支持 python 脚本，或者 WSL2 中 gdb 默认没开 ptrace 权限，这些细节不会报红，但会让你卡在“能连上，看不到变量”的死循环里。
