必须用clangd且compile_commands.json不可少；需显式配置lsp的"command"绝对路径，确保文件作用域为source.c++或source.cpp，并将compile_commands.json置于项目根目录或通过initializationoptions指定路径。
必须用 clangd，且 compile_commands.json 不能少；LSP 插件本身不分析代码，它只转发请求给 clangd —— 没 clangd 或没编译数据库，跳转和补全就是摆设。
clangd 启动失败或报 command not found
Sublime 的 LSP 插件不会自动安装 clangd，也不会读取系统 PATH 做模糊查找。它只认你配置里写的绝对路径。
- macOS：用
brew install llvm，clangd 默认在/opt/homebrew/opt/llvm/bin/clangd（Apple Silicon）或/usr/local/opt/llvm/bin/clangd（Intel），直接填进配置 - Linux：运行
sudo apt install clangd（Debian/Ubuntu），再用which clangd确认路径 - Windows：从 clangd 官方 release 页面 下载预编译 zip，解压后把
clangd.exe所在目录写死在配置里，例如C:/tools/clangd_18/bin/clangd.exe - 配置必须显式写在
LSP.sublime-settings的"clients"下，不能依赖默认值："clients": { "clangd": { "command": ["/opt/homebrew/opt/llvm/bin/clangd", "--background-index"] } }
打开 .cpp 文件却没触发 clangd
不是文件后缀对就行，Sublime 必须把当前 buffer 识别为 C++ 作用域，LSP 才会加载 clangd 客户端。
- 右下角状态栏看语法名：如果不是
C++，按Ctrl+Shift+P→Set Syntax: C++强制设置 - 检查作用域：按
Ctrl+Alt+Shift+P（Windows/Linux）或Cmd+Alt+Shift+P（macOS），输出应含source.c++或source.cpp - 若用了非标准后缀（如
.C、.tpp、.ipp），需在 LSP 配置中补全"enabled": ["source.c++", "source.cpp", "source.c"] - 确认 LSP 设置里没禁用 C++：
"selector": "source.c++, source.cpp"和"enabled": true都得有
跳转定义失败，提示 no semantic information
clangd 不靠猜，它靠 compile_commands.json 知道头文件在哪、宏怎么展开、模板怎么实例化。没有这个文件，它连 #include <vector></vector> 都可能解析失败。
- 项目根目录必须有
compile_commands.json；如果生成在build/子目录，配置里加："initializationOptions": { "compilationDatabasePath": "build" } - CMake 项目：执行
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..，会自动生成该文件 - 非 CMake 项目：可用
bear -- make或compiledb -- make拦截编译命令生成 - 文件存在但跳转仍失效？用
cat compile_commands.json | head -n 5看前几行是否含真实路径和参数；空文件或只有[]就等于没用
补全卡顿、跳转延迟高、后台 CPU 占满
clangd 默认开启 --background-index，对大型项目会持续扫描并建索引，但资源消耗明显。不关它，编辑体验反而下降。
- 小项目（--background-index，响应快
- 中大型项目：改用
--limit-results=50限制补全候选数，或加--suggest-missing-includes只开关键功能 - 彻底禁用后台索引（适合只读代码库）：去掉
--background-index，改用--index=disabled - 观察 Sublime 控制台（
Ctrl+`）：如果反复出现clangd: index update finished，说明索引正在反复重建，大概率是compile_commands.json路径错或内容不稳定
最容易被忽略的点：clangd 对 compile_commands.json 的位置极其敏感——它只认项目根目录或配置里明确指定的相对路径，不会向上递归查找父目录；而 Sublime 的“项目”概念和 clangd 的“编译数据库位置”不是一回事，哪怕你在 Sublime 里打开了正确文件夹，clangd 仍可能因路径没对上而静默降级为无语义模式。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
