根本原因是调试器解析智能指针模板时因头文件路径缺失、调试符号未生成及类型缓存损坏导致无限递归或挂起；需依次修复 includepath、添加 -g 编译选项并清除 c/c++ 扩展缓存。
VSCode 调试器展开 std::unique_ptr 或 std::shared_ptr 时卡死
根本原因不是智能指针本身，而是调试器在尝试解析其内部模板结构时，反复访问未正确索引的头文件或损坏的符号信息。尤其当 c_cpp_properties.json 中 includePath 缺失标准库路径（如 <memory></memory> 所在目录）时，VSCode 的 C/C++ 扩展会 fallback 到空解析状态，导致调试器在展开成员时陷入无限递归或超时等待。
- 确认
c_cpp_properties.json的includePath包含编译器对应的标准库头文件路径，例如 MinGW-w64 的"C:/mingw64/x86_64-w64-mingw32/include/c++/13.2.0"和"C:/mingw64/lib/gcc/x86_64-w64-mingw32/13.2.0/include" - 不要只写
"${workspaceFolder}/include"—— 这类路径对项目头文件有效，但对std::类型完全无效 - 运行
g++ -v -E -x c++ /dev/null（Linux/macOS）或g++ -v -E -x c++ NUL（Windows）获取真实 include 搜索顺序，只取前 3–4 行有效路径填入includePath
launch.json 中没配 stopAtEntry 导致卡死在初始化阶段
调试器卡在“正在启动调试器”界面后，再点开 std::shared_ptr<foo></foo> 展开箭头，极易触发卡死——这不是 UI 响应慢，而是调试器尚未完成符号加载就收到了变量查看请求。此时它既不能返回值，也无法报错，只能挂起。
- 务必在
launch.json的配置项中加入"stopAtEntry": true，确保调试器先停在main()入口，等所有符号加载完毕再交互 - 如果已启用该选项仍卡住，打开“调试控制台”（Debug Console），看是否有
Unable to read memory或Failed to read variable类错误 —— 这说明可执行文件缺少调试符号 - 编译命令必须带
-g（如g++ -g -O0 -o build/app app.cpp），-O2以上优化可能内联掉智能指针构造，导致调试器找不到原始类型信息
IntelliSense 引擎选错：Default 模式无法处理 C++20 智能指针模板推导
VSCode 默认用 ms-vscode.cpptools 自带的 Default IntelliSense 模式，它对 std::make_unique<t>()</t>、std::shared_ptr<const t></const> 等 C++17+ 特性支持极弱。调试时展开这类对象，语言服务器会反复尝试解析失败的模板实例，最终拖垮整个调试会话。
- 改用
clangd：卸载 C/C++ 扩展，安装官方clangd扩展，并在c_cpp_properties.json中设置"intelliSenseEngine": "disabled"（避免冲突） -
clangd需要项目根目录下有compile_commands.json；可用bear --make或 CMake 的-DCMAKE_EXPORT_COMPILE_COMMANDS=ON生成 - 禁用其他可能干扰的扩展，如 CMake Tools 的“自动配置 IntelliSense”，否则它会覆盖
clangd的行为
VSCode 缓存损坏导致智能指针类型缓存错乱
一旦某次调试因符号缺失中断过，C/C++ 扩展会在 ~/.vscode/extensions/ms-vscode.cpptools-*/.cache/ 下留下不一致的类型数据库。后续再展开 std::unique_ptr，调试器会读到残缺的模板定义，直接卡死或报 Cannot evaluate the expression。
- 手动删除缓存：
rm -rf ~/.vscode/extensions/ms-vscode.cpptools-*/.cache/（Linux/macOS）或rd /s/q "%USERPROFILE%\.vscode\extensions\ms-vscode.cpptools-*\.cache"（Windows） - 重启 VSCode 后，首次调试会稍慢（重建缓存），但之后展开
std::shared_ptr::get()、std::unique_ptr::operator->()就不会再卡 - 别依赖“重新加载窗口”——它不清除语言服务器底层缓存，必须删物理目录
includePath 正确，再确保 -g 编译，最后清缓存。任何一步跳过，都可能让 std::shared_ptr 变成定时炸弹。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
