关键是要让clangd读取compile_commands.json并桥接gdb/lldb调试：需在CMakeLists.txt中启用set(CMAKE_EXPORT_COMPILE_COMMANDS ON)，构建后将build/compile_commands.json软链接至项目根目录，同时配置launch.json明确区分clangd（代码分析）与微软插件（调试），并确保tasks.json含-g参数生成调试信息。
Clang开发环境在VS Code里不是“装个插件就完事”，关键得让clangd读得懂你的项目，同时让gdb或lldb能真正断点调试——这两件事默认互不兼容，必须手动桥接。
clangd启动失败：找不到compile_commands.json怎么办
VS Code里的clangd插件默认只认项目根目录下的compile_commands.json，没这个文件就退化成基础语法提示，跳转、补全、clang-tidy全失效。
- 用CMake生成它最稳：确保
CMakeLists.txt里开了set(CMAKE_EXPORT_COMPILE_COMMANDS ON)，然后运行cmake -S . -B build，生成的build/compile_commands.json要软链接或复制到项目根目录（clangd不自动找子目录） - 单文件项目别硬套CMake：直接写个最小
compile_commands.json，内容类似：[{"directory":"./","file":"main.cpp","command":"clang++ -std=c++17 -I/usr/include/c++/v1 main.cpp"}]注意directory路径必须是绝对路径或相对于JSON所在位置的相对路径 - Windows上路径斜杠别写错：
clangd在Win下对敏感，建议统一用/或双反斜杠\
c_cpp_properties.json里compilerPath该填clang++还是clangd
compilerPath填的是编译器路径，不是语言服务器路径——填clangd会直接导致IntelliSense崩溃。它只影响头文件索引和宏定义推导，和clangd本身无关。
- macOS系统自带Clang：填
/usr/bin/clang++（不是clang，后者缺C++标准库路径） - Homebrew装的LLVM：填
/opt/homebrew/opt/llvm/bin/clang++（M1/M2）或/usr/local/opt/llvm/bin/clang++（Intel） - Windows + LLVM安装包：填
C:/Program Files/LLVM/bin/clang++.exe，确认PATH里也有这个路径 - 填错的典型症状：
#include <iostream>报红、“无法解析符号”、std::前缀无补全
调试时GDB/LMDB连不上：微软插件和clangd怎么共存
微软C/C++插件（cpptools）和clangd默认抢launch.json控制权，结果常是调试器启动但断点无效，或clangd被强制禁用。
- 明确分工：删掉
cpptools自动生成的configurations里所有"type": "cppdbg"项，只保留一个"type": "lldb"（macOS）或"type": "cppvsdbg"（Windows + MSVC）或"type": "gdb"（Windows + MinGW / Linux） - 关键字段不能少：
miDebuggerPath必须指向真实gdb.exe或lldb可执行文件，比如"miDebuggerPath": "C:/msys64/mingw64/bin/gdb.exe" - Clang编译产物要带调试信息：
tasks.json里args必须含-g，且避免-O2以上优化（会破坏变量映射） - Mac上特别注意：Apple Clang默认用
libc++，但lldb调试时若链接了libstdc++会卡死，编译参数加-stdlib=libc++保平安
Clang-Tidy警告不显示：.clang-tidy配置被忽略
clangd读.clang-tidy文件，但只认项目根目录或源文件同级目录下的版本——放错位置等于没写。
- 文件名必须严格是
.clang-tidy（开头点号，小写），不是clang-tidy.yaml或clang_tidy.yml - 基础配置示例（存为项目根目录的
.clang-tidy）：Checks: '-*,cppcoreguidelines-*,modernize-*,performance-*,readability-*' CheckOptions: - key: readability-identifier-naming.VariableCase value: lower_case - Windows路径分隔符问题：如果
.clang-tidy里用了HeaderFilterRegex，正则中的要写成\，否则整个规则失效 - 改完配置后必须重启
clangd：Cmd/Ctrl+Shift+P → “clangd: Restart”（不是重载窗口）
真正卡住人的从来不是某个配置项写错，而是clangd静默失败——它不报错，只默默退回基础模式。盯住VS Code右下角状态栏的clangd图标颜色，灰色=挂了，蓝色=活着但没加载配置，绿色=正常工作。没绿，就别信补全和跳转。
