clang 和 cmake 可配合使用，但需 cmake 显式启用 cmake_export_compile_commands 生成 compile_commands.json，再由 clangd（非 clang 编译器）读取该文件以提供语义功能；clang 是编译器，clangd 是语言服务器，二者不可混淆。
Clang 和 CMake 能一起用，但默认不自动打通——关键在于让 CMake 生成 compile_commands.json，再让 clangd（不是 clang 编译器本身）读到它。否则补全、跳转、错误提示全是“哑的”。
Clang 编译器 vs clangd 语言服务器别混用
很多人卡在第一步：装了 Clang，clang --version 能跑，但 VSCode 里还是没补全、跳不到定义。问题不在编译器，而在 clangd 没拿到项目语义信息。
-
clang是编译器，负责把.cpp变成可执行文件 -
clangd是语言服务器，靠compile_commands.json知道每个源文件用了哪些头文件、宏、标准库路径 - VSCode 的
clangd插件默认只找build/compile_commands.json，找不到就退化成基础文本分析
CMake 必须导出 compile_commands.json
光写 CMakeLists.txt 不够，CMake 默认不生成 compile_commands.json。必须显式启用：
- 方式一（推荐）：在
CMakeLists.txt开头加一行set(CMAKE_EXPORT_COMPILE_COMMANDS ON) - 方式二：命令行构建时加参数
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON .. - 方式三（CMakePresets.json）：在
cacheVariables里设"CMAKE_EXPORT_COMPILE_COMMANDS": "ON"
生成后检查：build/compile_commands.json 文件大小不能是 2 字节（空文件），应有几十行以上 JSON 对象，每个含 file、command、directory 字段。
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
clangd 配置必须指向正确的 build 目录
clangd.arguments 里的 --compile-commands-dir 路径错了，clangd 就读不到编译数据库：
- 路径必须是
compile_commands.json所在的**父目录**，不是文件路径本身 - 例如文件在
./build/compile_commands.json，则配置应为"--compile-commands-dir=${workspaceFolder}/build" - Windows 下路径分隔符用正斜杠
/或双反斜杠\，单反斜杠会被 JSON 解析吃掉 - 如果用 Ninja 构建，确保
build目录下真有compile_commands.json——Ninja 默认不生成，得靠 CMake 导出
Windows 上 MinGW/MSVC/Clang 混用容易崩
Clang 在 Windows 下有两种常用模式，选错会导致头文件找不到、std::cout 标红：
-
clang++（GNU 模式）：依赖 MinGW 或 MSYS2 的libstdc++，需把 MinGW 的include和lib路径加入CMAKE_CXX_FLAGS -
clang-cl（MSVC 兼容模式）：用微软 STL，路径自动识别，但需确保 Visual Studio 或 Windows SDK 已安装 - VSCode 中通过
CMAKE_CXX_COMPILER指定：设为clang++还是clang-cl.exe，必须和你装的工具链匹配 - clangd 不关心你用哪个编译器，只认
compile_commands.json里记录的command字段——所以 CMake 配置要一致
最常被忽略的是：CMake 生成的 compile_commands.json 里每条 command 必须能真实执行。复制粘贴进去终端敲一遍，看是否报 fatal error: iostream: No such file or directory——那 clangd 也一样会跪。
