CLion Debug模式需正确配置run/debug配置及GDB/LLDB调试器：检查调试器可用性、创建CMake Application永久配置、确保构建类型为Debug并含调试符号、2026.2版起须匹配Debug Profiles。
CLion 的 Debug 模式不是“一键开启”的功能，而是依赖于正确配置的 run/debug configuration 和底层调试器（GDB/LLDB）可用性。如果你点击绿色虫子图标没反应、断点不生效、或提示 “No debug configuration”，问题几乎一定出在配置环节，而不是 IDE 本身坏了。
确认调试器已就绪（GDB/LLDB）
CLion 不自带调试器二进制，它依赖系统或工具链提供的 GDB 或 LLDB：
- Linux/macOS：检查终端能否运行
gdb --version或lldb --version；若报错，需安装对应调试器（如sudo apt install gdb） - Windows：CLion 捆绑了 GDB（
gdb.exe），但仅限于 MinGW 或 Cygwin 工具链；若用 MSVC，则必须启用LLDB for the MSVC toolchain（版本固定为 9.0.0*，不可替换） - 嵌入式场景（如 STM32 + OpenOCD）：调试器实际是
gdbserver或openocd启动的 stub，CLion 作为客户端连接，此时本地无需完整 GDB，但需确保arm-none-eabi-gdb可执行且路径已加入PATH
创建有效的 C/C++ 调试配置
临时配置（点击行号旁红点 → 绿色虫子）只对简单 main() 有效；一旦项目含 CMake、自定义构建或跨平台目标，必须建永久配置：
- 按
Alt+Shift+F10→0打开配置对话框，点击+→ 选CMake Application（非 “Application”） -
Executable字段不能手动填路径——应点击右侧...，从cmake-build-debug（或你设定的 build 目录）中选择生成的可执行文件（无后缀，非 .exe） - 确保
Build target正确（如my_project），否则 CLion 不会在启动前自动构建，导致调试旧二进制 - 若用自定义构建（如 ROS2、裸机固件），选
Custom Build Target，并指向你的构建脚本（如cmake_commands.bat），同时勾选Before launch: Build project
断点不命中？检查符号与构建设置
断点灰色、悬停显示 “no executable code found”，大概率是二进制缺少调试信息：
- CMake 项目必须在
CMakeLists.txt中显式启用调试符号：set(CMAKE_BUILD_TYPE Debug)或在 CLion 的Settings | Build, Execution, Deployment | CMake中将Build type设为Debug - 不要用
Release模式构建后强行调试——优化会内联函数、删除变量，断点位置失效，变量值显示为<optimized out> - 远程调试时，调试符号（.debug 文件或 .elf）必须在本地机器上，且路径要和编译时一致；CLion 不会自动下载符号
- 若用 NatVis 渲染 STL 容器（如 vector/map），需在
Settings | Build, Execution, Deployment | Debugger | Data Views | C/C++中启用Enable NatVis renderers for LLDB，否则复杂对象只显示地址
JavaScript/Python 调试是另一套机制
别混淆 C/C++ 的原生调试和脚本语言调试：
- JS 调试依赖
JavaScript Debugger插件（默认启用），且需通过内置 Web Server（端口 63342）提供文件；直接双击 HTML 文件打开浏览器无法触发断点 - Python 调试需确保解释器已配置（
Settings | Project | Python Interpreter），且Attach to subprocess automatically等选项按需开启；PyQt/Gevent 兼容性开关不匹配会导致启动失败 - 多语言混合项目（如 ROS2 的 C++ node + Python launch file）需分别配置：C++ 部分用
CMake Application，Python 部分用Python模板，并注意工作目录和环境变量隔离
最常被忽略的一点：CLion 2026.2 起，调试器选择已改为 Debug Profiles（主工具栏右端下拉），而非旧版的工具链设置。如果换了工具链但没切 profile，GDB 设置再对也连不上——profile 必须与当前运行配置的调试器类型（GDB/LLDB/DAP）严格匹配。
