Clang在Linux下需同时安装匹配版本的clang与clangd，CMakeLists.txt中显式强制设置CMAKE_C_COMPILER和CMAKE_CXX_COMPILER，禁用VS Code的C/C++扩展IntelliSense引擎，并确保compile_commands.json路径合法、权限可读。
Clang 在 Linux 下不是装完 clang 就能直接开干的——缺 clangd 会丢补全和跳转，不设 CMAKE_CXX_COMPILER 会让 CMake 无视你装的 Clang 继续用 GCC，update-alternatives 没配好则终端敲 clang++ 还是调 GCC。关键不在“装”，而在“接管编译链”。
确认 clang 和 clangd 都已安装且版本对齐
Ubuntu/Debian 系发行版默认仓库里的 clang 和 clangd 包名可能带版本号（如 clang-18、clangd-18），但 apt install clang clangd 安装的是“虚拟包”，实际指向的版本可能滞后或不一致。
- 先查真实安装路径：
ls /usr/bin/clang*，确认是否存在/usr/bin/clang-18和/usr/bin/clangd-18 - 运行
clang --version和clangd --version，输出的版本号必须完全一致；若不一致（比如 clang 是 18.1.3，clangd 是 17.0.1），说明插件和编译器错配，VS Code 中 clangd 会静默崩溃 - 推荐统一安装 LLVM 官方源：下载并执行
llvm.sh 18（来自https://apt.llvm.org/），再用sudo apt install clang-18 clangd-18，避免混用系统包和第三方包
CMakeLists.txt 中必须显式指定 Clang 编译器
即使系统 clang 已设为默认，CMake 默认仍优先查找 gcc 和 g++，除非你明确干预。只靠 set(CMAKE_CXX_COMPILER clang++) 不够稳定——它可能被后续工具链检测覆盖，尤其在启用 CMAKE_TOOLCHAIN_FILE 或多配置生成器时。
- 正确写法是在
CMakeLists.txt开头、project()之前插入： set(CMAKE_C_COMPILER clang CACHE FILEPATH "" FORCE)set(CMAKE_CXX_COMPILER clang++ CACHE FILEPATH "" FORCE)- 如果使用
CMakePresets.json，应在configurePresets中加"cacheVariables": {"CMAKE_C_COMPILER": "/usr/bin/clang-18", "CMAKE_CXX_COMPILER": "/usr/bin/clang++-18"}，路径必须绝对且可执行 - 验证是否生效：运行
cmake --build build --verbose，第一行应出现类似/usr/bin/clang++-18 -std=gnu++17 ...，而非/usr/bin/g++
VS Code 中 clangd 必须禁用 C/C++ 插件的 IntelliSense 引擎
微软官方 C/C++ 扩展（ms-vscode.cpptools）自带一个基于 tag-parser 的旧引擎，它和 clangd 同时运行会抢夺符号索引、导致跳转失效、补全卡顿甚至 CPU 拉满。这不是“选一个更好”，而是“必须关掉一个”。
- 打开 VS Code 设置（
Ctrl+,），搜索intellisense engine，将C_Cpp.default.intelliSenseEngine设为disabled - 不要依赖右下角弹出的 “Disable IntelliSense” 提示——它只改当前工作区设置，全局设置仍可能残留
- 检查
settings.json中是否含"C_Cpp.default.intelliSenseEngine": "disabled"；若没有，手动加上 - 重启 VS Code 后，在
Output面板切换到clangd日志，看到Found compilation database或Loaded compilation database才算真正接入成功
跨架构或交叉编译时，-target 参数不能省略
Clang 原生支持跨目标编译，但 Linux x86_64 上直接跑 clang --target=aarch64-linux-gnu 并不会自动找对头文件和库路径——它只会报 fatal error: 'stdio.h' file not found，因为默认 sysroot 是主机环境。
- 必须配合
--sysroot指向目标平台根目录，例如：clang --target=aarch64-linux-gnu --sysroot=/usr/aarch64-linux-gnu - 若用 CMake，应在
CMakeLists.txt中通过set(CMAKE_SYSTEM_NAME Linux)+set(CMAKE_SYSTEM_PROCESSOR aarch64)+set(CMAKE_SYSROOT "/usr/aarch64-linux-gnu")显式声明 - 更稳妥的做法是使用预构建工具链（如
aarch64-linux-gnu-gcc提供的gcc-toolchain），传参：clang --gcc-toolchain=/usr/lib/gcc-cross/aarch64-linux-gnu/12 - 注意：
clangd本身不执行编译，所以它无法解析带--target的命令；需在compile_commands.json中确保每条command字段已展开所有参数，否则跳转和诊断会失效
最常被忽略的一点：CMake 生成的 compile_commands.json 文件权限必须可读，且路径不能含空格或中文；clangd 启动后若日志里反复出现 Failed to parse compilation database，90% 是这个原因，而不是编译器没装好。
