根本原因是未安装clangd或其路径未加入$PATH；需按系统安装并显式配置LSP的"command"，确保文件作用域为C++，生成并校验compile_commands.json位置，必要时调整后台索引参数。

clangd 服务没启动或报错 command not found

根本原因是系统里没装 clangd，或者装了但不在 $PATH 里。Sublime LSP 不会帮你装二进制，它只调用你指定的路径。

• macOS 上推荐用 brew install llvm（不是 clang），装完 clangd 默认在 /opt/homebrew/opt/llvm/bin/clangd（Apple Silicon）或 /usr/local/opt/llvm/bin/clangd（Intel）
• Linux 用户用包管理器装 clangd 包，比如 Ubuntu/Debian： sudo apt install clangd，然后运行 which clangd 确认路径
• Windows 用户从 clangd 官方 release 页面 下载预编译 zip，解压后把 clangd.exe 所在目录加进系统环境变量，或直接在 LSP 配置里写绝对路径，如 C:/tools/clangd_17/bin/clangd.exe
• 在 Sublime 的 LSP.sublime-settings 中必须显式配置 "command"，不能依赖默认值：

  "clients": {
    "clangd": {
      "command": ["/opt/homebrew/opt/llvm/bin/clangd", "--background-index"]
    }
  }

打开 C++ 文件没触发 clangd，或提示 No language server for cpp

这是 Sublime 没把当前文件识别为 C++ 作用域，LSP 插件就不会自动启用 clangd。

• 确认文件后缀是 .cpp、.cc、.h、.hpp 等标准扩展名；如果用了 .C（大写）或 .tpp，需手动在 LSP 配置中补全 "enabled": ["source.c++", "source.cpp"]
• 检查右下角状态栏——当前语法是否显示为 C++？如果不是，用 Ctrl+Shift+P → Set Syntax: C++ 强制设置
• 确保 LSP-clangd 的 settings 里没禁用 C++：

  "enabled": true,
  "selector": "source.c++, source.cpp"

• 如果项目有 compile_commands.json，但放在子目录（比如 build/compile_commands.json），需要在 LSP 配置里加 "initializationOptions": {"compilationDatabasePath": "build"}

跳转定义/补全失效，或提示 no semantic information

clangd 需要准确的编译信息才能理解代码，纯靠文件后缀和头文件包含推导非常有限，尤其涉及宏、模板、第三方库路径时。

• 优先生成 compile_commands.json：用 CMake 时加 -DCMAKE_EXPORT_COMPILE_COMMANDS=ON，构建后该文件会出现在 build 目录；用 Makefile 或其他构建系统，可借助 compiledb 工具生成
• 不要把 compile_commands.json 放在项目根目录以外的位置，除非你明确配置了 compilationDatabasePath
• 如果用了自定义 include 路径（比如 -I /usr/local/include/mylib），确保这些路径已写入 compile_commands.json；否则 clangd 会找不到头文件，导致补全为空或跳转失败
• 检查 clangd 日志：打开 Sublime 控制台（Ctrl+`），执行 LSP: Toggle Log Panel，看是否有 Failed to load compilation database 或 Could not find header 类错误

配置生效但 CPU 占用高、响应卡顿

clangd 默认开启 --background-index，对大型项目（尤其是含大量模板或 Boost 的项目）会持续占用 1–2 核 CPU，且首次索引可能长达数分钟。

立即学习“C++免费学习笔记（深入）”；

• 临时关闭后台索引：把配置里的 "--background-index" 换成 "--limit-results=100"（限制补全项数量）或直接删掉该参数
• 限制内存使用：加 "--malloc-trim" 参数（Clangd ≥ 16），或通过 "--j=2" 限制并行线程数（j 值建议设为 CPU 核心数的一半）
• 避免在非 C++ 项目根目录打开 Sublime：LSP 会递归扫描整个文件夹，若根目录下有 node_modules、build 等大目录，clangd 可能误读或卡住；建议用 Project → Add Folder to Project 只添加 src 目录
• Windows 上注意防病毒软件实时扫描 clangd.exe 进程，可能导致频繁卡顿；可将 clangd 安装目录加入白名单

实际项目里最常被跳过的环节是 compile_commands.json 的生成与位置校验——很多人以为只要装了 clangd 就能“开箱即用”，但 C++ 没有统一的模块系统，clangd 必须靠构建信息才能真正理解你的代码。