clangd补全失效的根本原因是路径未正确配置、compile_commands.json缺失或位置错误、文件作用域未识别为c++。需显式设置command绝对路径、指定compilationdatabasepath、确保语法为c++并启用对应scopes。
clangd 路径没配对，补全根本不会启动
Sublime LSP 不会自动找 clangd，哪怕你用 brew install llvm 或 apt install clangd 装好了，它也只认你配置里写的路径。常见错误是直接留空或写 clangd（没加路径），结果日志里全是 command not found。
macOS Apple Silicon 用户路径通常是 /opt/homebrew/opt/llvm/bin/clangd；Intel Mac 是 /usr/local/opt/llvm/bin/clangd；Ubuntu/Debian 一般在 /usr/bin/clangd；Windows 必须写绝对路径，比如 C:/tools/clangd_17/bin/clangd.exe。
- 打开
LSP.sublime-settings，确认"command"是数组形式：["/path/to/clangd", "--background-index"] - 别信“系统已装就不用管”——运行
which clangd（macOS/Linux）或where clangd（Windows）亲自验证 - 如果用的是 clangd 17+，
--background-index推荐加上，否则大型项目首次补全会卡住几秒
compile_commands.json 位置不对，C++20 模块和概念补全直接失效
clangd 看不到编译参数，就不知道你用了 -std=c++20、启用了模块（-fmodules）或设置了 -I 路径，补全只能猜 std::vector 这种基础类型，std::ranges::filter_view 或自定义模块接口就完全不出现。
最稳的方式是用 CMake 生成：在项目根目录运行 cmake -S . -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DCMAKE_CXX_STANDARD=20，然后确保 build/compile_commands.json 存在。
- 如果
compile_commands.json在build/下，必须在 LSP 配置里加："initializationOptions": {"compilationDatabasePath": "build"} - 不能靠
.clangd文件硬塞-std=c++20—— 单文件配置无法覆盖模块依赖关系，clangd 仍无法解析import std; - 用 Ninja 或 Make 构建的项目，可用
bear --make或compiledb工具生成，但生成后务必检查 JSON 里每条命令是否含-std=c++20和-fmodules
文件作用域没识别成 C++，clangd 压根不加载
右下角状态栏显示 “Plain Text” 或 “C” 而不是 “C++”，说明 Sublime 没把当前文件当 C++ 处理，LSP 就不会触发 clangd 客户端。哪怕你写了满屏 import 和 concept，补全也永远是灰色的。
标准后缀如 .cpp、.hpp 通常没问题，但 .cc、.cxx、.tpp 或大写 .C 默认不被 LSP 的 clangd 客户端识别。
- 手动设置语法：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入Set Syntax: C++→ 回车 - 在
LSP.sublime-settings的clangd配置段里，显式补全"scopes"：["source.c++", "source.cpp", "source.c++11", "source.c++20"] - 检查
"enabled"是否为true，且没被其他插件（如 SublimeClang）禁用——两者冲突会导致 clangd 启动后立即断连
C++20 模块补全卡顿或不完整，其实是索引没跑完
clangd 对模块（module interface unit）的索引比传统头文件重得多，首次打开项目时可能要 10–30 秒才开始返回补全项，期间敲 std:: 什么也不出来，容易误判为失败。
这不是 bug，是设计使然：clangd 必须解析所有 export module 和 import 关系才能构建符号表。如果中途关闭 Sublime 或 kill 了 clangd 进程，下次还得重来。
- 观察状态栏：看到
clangd: indexing...时别急着删配置，等它变成clangd: ready - 如果长期卡在 indexing，检查
compile_commands.json里模块相关参数是否生效——-fmodules和-fmodule-maps必须存在，且路径指向正确的 module map 文件 - 避免在项目根目录放超大第三方库源码（如 LLVM 源码树），clangd 会试图索引全部，导致内存爆掉或响应停滞
-fmodules 或模块路径错一位，import 行就永远不亮，补全也只停留在 std:: 前缀。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
