Clion调试动态库必须手动加载符号，否则断点灰色、调用栈显示???、局部变量不可见；需确保编译带-g、正确配置Debugger→Shared Libraries路径，并在Run/Debug配置中启用对应平台的符号自动加载选项。
Clion调试动态库程序必须先加载符号
Clion本身不自动加载动态库的调试符号，gdb或lldb在遇到未加载符号的.so/.dylib/.dll时，断点会变成灰色、无法命中，甚至跳过函数体。这不是配置错误，而是符号路径没被识别。
常见现象包括：在动态库源码里打了断点，但运行时断点未激活；调用栈显示???或地址而非函数名；frame variable看不到局部变量。
- Linux/macOS：确保编译时加
-g且未strip，CMake中写set(CMAKE_BUILD_TYPE Debug) - Windows：用MSYS2的
clang++生成.dll时，必须同时生成.pdb（Clang默认不生成），建议改用set(CMAKE_CXX_FLAGS_DEBUG "$ENV{CXXFLAGS} -g")并确认cmake-build-debug/下有对应.dll和.pdb - CLion中需手动指定符号搜索路径：Settings → Build, Execution, Deployment → Debugger → Shared Libraries → + 添加动态库所在目录（如
cmake-build-debug/）
调试主程序调用动态库的场景
这是最常见也最容易出问题的调试模式：主程序是add_executable，动态库是add_library(SHARED)，二者通过target_link_libraries链接。Clion默认只对主可执行文件启用调试，动态库代码不会被自动纳入调试上下文。
关键动作不是“启动动态库”，而是让调试器知道“这个.so的源码在哪”。否则即使断点打对了位置，gdb也不知道该停在哪一行。
- 确保动态库项目与主项目在同一个CMake workspace里（即共用一个
CMakeLists.txt或子目录包含关系） - 在主项目的
Run/Debug Configuration中，勾选 “Include system libraries”（Linux/macOS）或 “Load symbols for shared libraries automatically”（Windows） - 如果动态库是外部构建的（比如预编译的
libmylib.so），必须把它的源码目录显式添加到Debugger → Sources路径映射中，否则step into进去看到的是汇编
附加到已运行进程调试动态库
当动态库被第三方程序（如Java JVM、游戏引擎、后台服务）加载时，你无法从CLion启动主进程，只能用Attach to Process。这时符号加载更脆弱，稍有疏漏就完全不可调试。
典型失败表现：附加成功，但所有动态库函数都显示为<symbol not found></symbol>；info sharedlibrary在调试控制台里看不到你的库。
- Linux：运行目标进程前，先执行
export LD_LIBRARY_PATH=/path/to/your/libs:$LD_LIBRARY_PATH，确保它加载的是带-g的版本 - macOS：除了
DYLD_LIBRARY_PATH，还需确认codesign没破坏调试信息（尤其在Apple Silicon上，禁用hardened runtime） - Windows：用
Process Explorer确认目标进程确实加载了mylib.dll（而非同名但无调试信息的旧版），且.pdb文件与.dll在同一目录 - CLion中Attach后，立即在Debug Console里执行
sharedlibrary libmylib（Linux/macOS）或add-symbol-file path/to/mylib.pdb（Windows），强制加载
JNI场景下调试C++动态库特别容易卡在哪
Java调用System.loadLibrary("mylib")后，CLion调试器默认不跟踪JVM内部的dlopen行为，导致动态库加载完成时，调试上下文还没准备好——断点已经错过。
这不是CLion的缺陷，而是JVM和本地调试器的协同边界问题。很多开发者反复重启Java进程，却没意识到问题出在时机上。
- 不要等Java程序跑完再Attach：在Java侧加
Thread.sleep(5000)留出窗口，在CLion里快速Attach - 确保Java进程是用
-agentlib:jdwp以外的方式启动的（纯本地调试不需要JDWP），否则CLion会混淆调试通道 - 如果用JNA，注意
NativeLibrary.getInstance("mylib")可能触发延迟加载，断点要打在实际被调用的C++函数入口，而不是Jna_add这种包装层 - Windows下务必关闭
Enable native memory tracking（JVM参数-XX:NativeMemoryTracking=off），否则gdb会因内存映射冲突挂起
