CLion调试需通过配置启用而非开关切换：设断点后点击绿色虫子图标可自动生成临时CMake调试配置；调试器由Debug Profiles统一管理，须匹配平台与工具链；断点不命中常因构建类型非Debug、源码路径映射错误或可执行路径指向旧二进制。
CLion 的 Debug 模式不是开关式切换，而是通过选择或创建一个带调试能力的运行/调试配置来启用——关键在配置类型、调试器绑定和启动方式，而不是“按个按钮就进 Debug”。
如何快速启用一次调试（临时配置）
只要项目能正常编译，最直接的方式是：在 main() 函数所在行号左侧单击设断点 → 点击编辑器右上角的绿色虫子图标 Debug（不是旁边的三角形 Run）→ CLion 会自动生成一个临时的 CMake Application 调试配置并启动。
- 这个临时配置只在当前会话有效，图标是半透明的；关闭后不会保留
- 如果没看到虫子图标，说明当前文件未被识别为可执行入口（比如没
main()，或 CMakeLists.txt 里没正确 add_executable） - 若点击后报错
No executable specified，说明 CMake 构建目标未生成或路径未识别，需先 Build Project（Ctrl+F9）
如何固定使用某个调试器（LLDB/GDB 切换）
从 CLion 2026.2 开始，调试器不再在 Toolchain 设置里硬编码，而是通过 Debug Profiles 统一管理。你必须先确认当前 profile 是否匹配你的平台和可执行格式：
- macOS/Linux 下调试原生 C++：默认用
LLDB 21.1.7，profile 名通常是LLDB (default) - Windows 下用 MinGW 工具链：选
GDB 17.1profile；用 MSVC 工具链则需选LLDB for the MSVC toolchain - profile 不匹配会导致启动失败，错误信息类似：
Cannot connect to debugger: failed to launch GDB - 修改位置：
Settings | Build, Execution, Deployment | Debugger | Debug Profiles，点击当前 profile 右侧铅笔图标可编辑路径和参数
为什么断点不命中？常见配置陷阱
断点灰色、提示 no executable code is associated 或程序直接跑过不停，往往不是代码问题，而是构建与调试配置脱节：
- CMake 构建类型不是
Debug：检查右上角运行配置切换器中是否选了Debug（而非Release或RelWithDebInfo），否则符号表被剥离 - 源文件不在项目目录内：用
File | Open打开外部源码时，CLion 会警告 “file does not belong to the project”，但只要调试器能定位到对应二进制的 DWARF/PE 调试信息，仍可调试——关键是确保可执行文件路径和源码路径映射正确（可通过Settings | Debugger | Data Views | C/C++ | Source Path Mapping手动添加） - 调试配置里指定的
Executable路径指向了旧版本二进制（比如手动make后没刷新 CMake 缓存），需点击配置里的Reload project from CMakeLists.txt按钮
调试外部已编译程序（非本项目构建）
不依赖 CMake，也能调试任意本地 .out / .exe 文件，但必须绕过“构建阶段”：
- 新建一个空 CMake 项目（或直接打开任意源码文件夹），然后
Run | Edit Configurations→ 点+→ 选Custom Build Application - 填入绝对路径到你的可执行文件：
Executable字段（如/path/to/myapp） - 清空
Build target和Before launch里的所有项（尤其是Build），否则 CLion 会尝试重新编译 - 设置好断点后，用
Debug启动即可——此时 CLion 实际是调用 GDB/LLDB 的target exec命令加载二进制 - 注意：若该程序依赖动态库，需在
Environment variables中补全LD_LIBRARY_PATH（Linux/macOS）或PATH（Windows）
真正卡住人的地方，往往不是“怎么点”，而是构建类型、调试器 profile、源码路径映射这三者没对齐。尤其在跨机器调试或复用旧二进制时，花两分钟核对 Debug Profiles 和 CMake build type，比反复重启 IDE 有效得多。
