Sublime Text需手动配置LSP插件、clangd二进制路径及compile_commands.json三者，缺一不可；否则补全、跳转等功能全部失效。
Sublime Text 默认不带 C++ 语言服务，必须手动配置 LSP 插件 + clangd 二进制 + 项目级编译信息，三者缺一不可；否则补全、跳转、重命名等功能全部失效。
安装 LSP 插件并确认启用
LSP 是客户端，不自带任何语言服务器，装完后需手动配置 clangd 才能生效。它不会自动扫描 PATH 或提示你缺什么。
- 用
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板，输入Package Control: Install Package→ 回车 → 搜索LSP→ 安装 - 安装完成后，
Ctrl+Shift+P输入LSP Settings，打开右侧用户设置面板 - 确保 JSON 格式合法，最外层是
{}，不要有多余逗号或注释 - 若已装过旧版 LSP，重启 Sublime Text 再检查，GUI 启动时可能未加载最新环境变量
配置 clangd 路径：不能依赖默认值
command not found: clangd 是最常见报错，根本原因不是“没装 clangd”，而是 LSP 没法调到它——Sublime 不读 shell 的 ~/.zshrc，Windows GUI 启动也不继承 CMD 的 PATH。
- macOS（Apple Silicon）：
brew install llvm后，clangd在/opt/homebrew/opt/llvm/bin/clangd；Intel 芯片则在/usr/local/opt/llvm/bin/clangd - Linux（Ubuntu/Debian）：
sudo apt install clangd，再运行which clangd确认路径，通常是/usr/bin/clangd - Windows：从 clangd 官方 release 页面 下载预编译 zip，解压后把
clangd.exe所在目录（如C:/tools/clangd_18/bin）写死进配置，别只写clangd - 在 LSP 用户设置中显式填入：
"clients": { "clangd": { "command": ["/opt/homebrew/opt/llvm/bin/clangd", "--background-index"] } }
让 clangd 正确识别 C++ 文件和项目上下文
即使 clangd 进程跑起来了，如果 Sublime 没把当前文件当 C++ 处理，LSP 就不会启动 clangd —— 右下角状态栏显示 “Plain Text” 或 “C” 就是铁证。
立即学习“C++免费学习笔记（深入）”；
- 检查文件后缀是否为
.cpp、.cc、.hpp、.h；.C（大写）或.tpp默认不识别，需在 LSP 配置中补全："enabled": ["source.c++", "source.cpp", "source.c++-header"] - 右下角语法不对？按
Ctrl+Shift+P→ 输入Set Syntax: C++强制设置 - 项目必须有
compile_commands.json，且位置合理：默认找项目根目录；若在build/compile_commands.json，必须加"initializationOptions": { "compilationDatabasePath": "build" } - 生成该文件：CMake 项目加
-DCMAKE_EXPORT_COMPILE_COMMANDS=ON；非 CMake 项目用compiledb make（需先pip install compiledb）
补全/跳转仍失效？重点查这三项
clangd 报 no semantic information 或定义跳转到头文件声明却进不去实现，问题几乎都出在编译信息缺失或路径错位，跟插件版本关系不大。
-
compile_commands.json里每条command字段是否含完整编译参数？尤其-I路径是否真实存在、是否用了相对路径但directory字段没对齐？可用jq '.[0].command' compile_commands.json快速检查 - 项目含子模块或第三方库？在项目根目录建
.clangd文件，写入：CompileFlags: Add: [-I/path/to/your/third_party/include]
- macOS 上用 Xcode 自带 clang 编译但 clangd 来自 Homebrew LLVM？二者 stdlib 和 header 路径不一致，补全会漏符号；统一用 Homebrew 的
clang++-18构建项目更稳
最容易被忽略的是：Sublime GUI 启动时完全不继承 shell 的 PATH 和环境变量，哪怕终端里 clangd --version 跑得通，LSP 也可能找不到它——Windows 要改系统 PATH，macOS/Linux 必须写绝对路径，别信“应该可以”。
