必须在编译时嵌入调试符号(如-g或/zi),否则clion无法命中断点、查看变量或显示调用栈;需在cmakelists.txt中配置cmake_cxx_flags_debug,重载项目后设断点、启动调试或附加进程,并利用variables/watches和快捷键高效调试。

要在CLion中真正开始调试C++程序,必须先确保调试器能识别源码与执行流的对应关系,这要求编译时嵌入调试符号,否则断点无法命中、变量无法查看、调用栈一片空白。
确认项目已启用调试信息生成
打开项目的 CMakeLists.txt 文件,在 set(CMAKE_BUILD_TYPE Debug) 行下方或 add_executable 之前添加:set(CMAKE_CXX_FLAGS_DEBUG "$ENV{CMAKE_CXX_FLAGS_DEBUG} -g")。
若使用 MSVC 工具链,则替换为 /Zi;若使用 Clang,则保持 -g 即可。这一步漏掉,后续所有调试操作都将失效。
点击右上角 【Reload CMake project】 按钮(或按 Ctrl+Shift+O),让 CLion 重新解析构建配置并应用新标志。
设置并触发断点
在你想暂停执行的代码行左侧灰色装订区单击,出现实心红点即表示断点已设好。
右键该断点 → 选择“More…” → 在 Condition 字段输入 i == 5(假设你在循环里调试),这样程序只会在第5次迭代时中断,避免手动反复按 F9。
注意:断点必须设在可执行语句上,比如不能设在空行、注释行或函数声明行,否则 CLion 会自动将其移到下一条有效语句——但这个行为不总可靠,【务必确认红点右侧高亮的是你预期的那行代码】。
启动调试会话
第一步:确保当前编辑的文件中存在 main() 函数,或已在 Run/Debug Configurations 中指定正确入口;
第二步:点击工具栏绿色甲虫图标(Debug)或按 Shift+F9;
第三步:CLion 自动构建(若需)、启动调试器、加载符号、停在首个断点处。
如果控制台输出 “Process finished with exit code 0” 而未进入调试界面,说明配置未指向可执行目标——请立即前往 Run → Edit Configurations,检查 “Target executable” 是否为空或路径错误。
附加到已运行进程(无需从IDE启动)
方法一:终端中手动运行程序
打开 View → Tool Windows → Terminal,执行 ./your_program &(Linux/macOS)或 start /B your_program.exe(Windows),记下进程 PID(Linux/macOS 用 ps aux | grep your_program,Windows 用 wmic process where "name='your_program.exe'" get processid)。
方法二:在 CLion 中附加
选择 Run → Attach to Process(Ctrl+Alt+F5),在弹出列表中找到对应进程名或输入 PID,双击确认。此时 CLion 不重建项目,直接注入调试器,适用于守护进程、服务类程序。
附加成功后,你仍可设断点、查看变量、单步执行——但前提是该进程启动时已带 -g 编译选项且源文件路径与调试时打开的一致。
调试过程中快速定位关键状态
当程序停在断点时,打开 Debug Tool Window → Variables 面板,展开局部变量查看值;右键任意变量 → “Add to Watches” 可将其固定在监视栏,避免反复展开嵌套结构。
在 Watches 区域直接输入表达式,例如 std::string(str1 + str2) 或 vec.size() > 10,回车即可实时求值——这比在控制台手敲 print 快得多。
按下 F8 单步跳过函数调用,F7 进入函数内部,Shift+F8 跳出当前函数;若卡在系统库中,点击 Call Stack 中上层你自己写的函数帧,双击即可直接跳转到对应源码行。











