clion调试多线程c++程序默认采用gdb all-stop模式，即任一线程断点触发时所有线程暂停；需手动配置set non-stop on和set target-async on启用non-stop模式，使断点仅停止单线程而其余线程继续运行，从而真实暴露竞态、死锁等问题。
CLion 调试多线程 C++ 程序默认会暂停所有线程，这在多数场景下反而掩盖了竞态、死锁或资源争用问题。要真正看清线程行为，必须显式启用 non-stop 模式并正确配置线程视图。
为什么断点一触发，其他线程就“卡死”了
这是 GDB 默认的 all-stop 模式导致的：只要任意线程命中断点，GDB 就会冻结整个进程的所有线程。对调试线程协作逻辑（比如生产者-消费者、信号量等待）非常不利——你看到的只是单一线程快照，而非并发真实态。
-
non-stop模式才是关键：它允许一个线程停在断点时，其余线程继续运行 - CLion 并不自动开启该模式，需手动在调试配置中添加 GDB 命令
- 仅当调试器后端为 GDB（非 LLDB）且版本 ≥ 7.10 时才支持
在 Run/Debug Configurations 中启用 non-stop
打开 Run | Edit Configurations，选中你的 CMake Application 配置，在 Debugger 标签页底部找到 GDB command line options 输入框，填入：
--nx -ex "set non-stop on" -ex "set target-async on"
注意：--nx 禁用 .gdbinit 加载，避免冲突；两个 -ex 命令必须成对出现，缺一不可。
- 若使用远程调试（
gdbserver），还需在 gdbserver 启动时加--once参数，否则连接后立即退出 - macOS 上若用 LLDB 后端，则
non-stop不可用——必须切回 GDB（CLion 捆绑版或自行安装） - 配置保存后，重启调试会话才会生效，已运行的调试进程不会动态切换
查看和切换活跃线程的正确姿势
进入调试后，左侧 Frames 面板顶部会显示当前线程下拉菜单（如 Thread #2 (proc)），但很多人忽略：这个菜单只反映“当前栈帧所属线程”，不代表其他线程不可见。
- 打开 Threads 工具窗口（
Alt+6或 View | Tool Windows | Threads），才能看到全部线程列表及状态（running / stopped / sleeping） - 点击任一线程可立即跳转到其当前执行位置，并在 Variables 面板中查看该线程独有变量（如
std::thread::id、局部变量） - 右键线程可选择 Suspend 或 Resume，这是验证线程间依赖关系最直接的方式
pthread 编译链接失败导致调试根本启动不了
如果调试前就报错 undefined reference to pthread_join 或 pthread_create，说明链接阶段没带 -pthread，调试器连可执行文件都生成不了。
在 CMakeLists.txt 中必须明确声明：
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -pthread")
不要用 find_package(Threads) + target_link_libraries 的方式——CLion 的 CMake 解析有时无法将 Threads 库正确注入调试配置。
- 检查生成的
compile_commands.json，确认每条命令末尾含-pthread - 若项目含 C 和 C++ 混合源码，需同时设置
CMAKE_C_FLAGS和CMAKE_CXX_FLAGS - Release 模式下
-O2可能内联线程函数，导致断点无法命中——调试务必用RelWithDebInfo或Debug构建类型
线程调试真正的复杂点不在设置，而在于你是否意识到：每个线程都有独立的调用栈、寄存器上下文和内存视图，CLion 的 UI 只是把它们折叠在同一个窗口里。一旦你开始依赖 Threads 面板主动筛选、挂起、比对不同线程的变量值，调试才真正从“看代码”变成“看并发”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
