clangd比sublime text原生补全强，因其基于clang解析ast实现语义级补全，能正确处理模板、重载、命名空间嵌套及成员访问过滤；而原生补全仅依赖后缀和关键字匹配，遇到std::vector::iterator等即失效。
Clangd 为什么比 Sublime Text 自带补全强
Sublime Text 原生的 C++ 补全只靠文件后缀和简单关键字匹配，不理解模板、重载、命名空间嵌套，遇到 std::vector<:string>::iterator</:string> 这种就直接哑火。Clangd 是 Clang 的语言服务器实现，能真正解析 AST，补全结果基于实际语义——比如输入 vec. 后列出所有成员函数，且自动过滤掉 const 成员（当 vec 是非常量对象时）。
但前提是 Clangd 必须拿到正确的编译参数，否则它连头文件在哪都不知道，补全会大量报错或空白。
如何让 Clangd 正确读到 compile_commands.json
Clangd 默认只在项目根目录找 compile_commands.json，且要求路径是绝对路径。常见错误是：用 CMake 生成时没加 -DCMAKE_EXPORT_COMPILE_COMMANDS=ON，或者生成后把文件挪动过导致 JSON 里 file 字段的路径失效。
- 用 CMake 生成时，确保执行：
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -B build - 生成后不要移动
compile_commands.json，而是用软链接或配置 Clangd 启动参数指向正确位置 - 如果项目没用 CMake，可用
bear --make或compiledb工具从 Makefile 生成 - 验证 JSON 是否有效：打开任意一项，检查
file字段路径是否存在、能否被 Clangd 进程读取（注意权限和工作目录）
Sublime Text 中配置 LSP 插件连接 Clangd
必须用 LSP 插件（不是旧版 SublimeCodeIntel），且版本 ≥4.0。老版本对多根工作区或 Windows 路径处理有 bug，会导致 Clangd 启动失败或静默退出。
在 LSP.sublime-settings 里配 clients.clangd，关键项：
-
command：填绝对路径，比如["/usr/bin/clangd"]（Linux/macOS）或["C:\Program Files\LLVM\bin\clangd.exe"]（Windows） -
enabled：设为true，别只写clangd不设开关 -
settings下加"clangd.arguments": ["--log=error"]，避免日志刷屏；调试时可改info - 如果项目有多个 build 目录，用
initializationOptions指定compilationDatabasePath，值为相对于 Sublime 工作区的路径，比如"build/compile_commands.json"
补全失效或跳转失败的三个高频原因
补全框弹出来但选项全是 auto、template 这类关键字，或者 F12 跳转提示 “No definition found”，大概率是以下之一：
- Clangd 启动后报
Failed to load compilation database—— 检查 Sublime 控制台（Ctrl+`），确认 JSON 路径和内容是否合法 - 头文件用了非标准路径（如
#include "utils/math.h"），但compile_commands.json里没包含-I参数 —— 需在 CMake 中用target_include_directories显式导出，或手动往 Clangd 参数加--query-driver（慎用，有安全风险） - 编辑的是头文件（
.h），但对应源文件（.cpp）未被编译命令覆盖 —— Clangd 对头文件的语义分析依赖其被某条编译命令引用，单独打开foo.h时可能无法推导完整上下文
Clangd 的诊断信息全在 Sublime 底部状态栏和控制台里，别只盯着补全框看；真正的难点从来不是装插件，而是让编译参数和文件路径严丝合缝地对上。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
