clion调试多线程程序默认启用gdb的all-stop模式，触发断点时所有线程均暂停；需手动勾选“use non-stop mode”或添加--init-command="set non-stop on"参数，并确保编译带-g调试信息、正确链接threads库及配置符号路径。
CLion 调试多线程程序，默认会停所有线程，这不是 bug，是 GDB 的默认行为；要真正观察线程并发行为，必须显式启用 non-stop 模式并正确配置调试器。
non-stop 模式必须手动开启，否则断点一触发就全局暂停
CLion 底层用的是 GDB（Linux/macOS）或 LLDB（macOS 可选），而 GDB 默认是 all-stop 模式：任一线程命中断点，所有线程都会被冻结。这对多线程调试几乎无用——你根本看不到其他线程在做什么、是否卡在锁上、有没有死循环。
解决方法是强制 GDB 进入 non-stop 模式：
- 在 CLion 的
Run | Edit Configurations...中，找到你的调试配置 → 展开Debugger选项卡 → 勾选Use non-stop mode - 如果没看到该选项（旧版 CLion 或某些工具链），可在
GDB path后追加启动参数：--init-command="set non-stop on" - 验证是否生效：调试时在
Debug工具窗口底部的Console标签页里，输入show non-stop，应返回non-stop mode is on.
线程视图不显示？检查调试符号和源码路径映射
即使启用了 non-stop，你也可能只看到一个线程——常见原因是调试器找不到线程栈帧对应的源码位置，导致线程列表为空或只显示 ???。
关键检查点：
- 确保编译时带完整调试信息：
-g -O0（Release 版本禁用优化，否则内联/寄存器变量会让调试失效） - 若程序在远程开发板运行（如 ARM），需确认
gdbserver启动时未 strip 符号，且 CLion 的Symbol file路径指向本地未 strip 的可执行文件 - 在
Run | Edit Configurations...→Startup scripts里添加命令：set sysroot /path/to/sysroot（尤其交叉编译环境，否则找不到pthread等系统符号）
pthread 相关链接错误（如 undefined reference to pthread_join）会直接阻断调试准备
这不是运行时问题，而是构建阶段失败——没有成功生成可调试二进制，后续一切调试配置都无效。
CMake 项目中必须显式启用线程支持：
- 在
CMakeLists.txt中添加：find_package(Threads REQUIRED)，然后在target_link_libraries(your_target PRIVATE Threads::Threads) - 不要用过时的
SET(CMAKE_CXX_FLAGS -pthread)，它不保证链接顺序，且在现代 CMake 中已被弃用 - 验证是否生效：编译后执行
readelf -d your_binary | grep NEEDED，应看到libpthread.so.0
FreeRTOS 或其他 RTOS 场景下，标准线程视图完全不可用
CLion 的线程面板只识别 POSIX 线程（pthread）。FreeRTOS 任务不是 OS 级线程，GDB 默认根本看不见它们——你看到的只是空闲任务或某个硬编码的主线程。
要可视化 FreeRTOS 任务状态，必须：
- 在
FreeRTOSConfig.h中启用：#define configUSE_TRACE_FACILITY 1和#define configUSE_STATS_FORMATTING_FUNCTIONS 1 - 使用 CLion 的
Custom Build Application配置，并在Before launch中添加脚本，自动注入 FreeRTOS GDB Python 扩展（如FreeRTOSPlugin.py） - 调试时在 GDB Console 手动执行：
source /path/to/FreeRTOSPlugin.py，再运行rtos tasks查看任务列表
这个环节最容易被跳过：没加载插件，CLion 就永远只显示一个“thread 1”，哪怕你有 12 个 FreeRTOS 任务在跑。
