如何高效正确使用Clangd，无需频繁编译即可获取准确语法提示

我完全懂你的困扰——每次要等编译才能看到最新的语法错误，甚至加个空行都得手动刷新提示，确实比IntelliSense的即时反馈麻烦不少。其实Clangd的核心是依赖编译数据库（compile_commands.json），只要把这个配置到位，根本不用频繁编译也能获得精准的语法提示和错误检查。下面我给你拆解下正确的使用姿势：

• 第一步：生成并维护正确的编译数据库
  Clangd之所以需要编译信息，是因为它要知道你的代码是用什么标准、哪些头文件路径、宏定义来编译的。这个信息都存在compile_commands.json里：

  • 如果用CMake构建，只要在配置时加上-DCMAKE_EXPORT_COMPILE_COMMANDS=ON，构建后就会在build目录生成这个文件，把它软链接或者复制到项目根目录就行；
  • 如果用Makefile，可以用bear make命令来生成编译数据库（bear会拦截编译命令并记录下来）；
  • 要是手动管理项目，你可以自己编写这个JSON文件，每个条目对应一个源文件的编译命令，比如包含-I指定头文件路径、-std=c++17指定语言标准等。
    确保这个文件放在项目根目录，或者在编辑器设置里指定它的路径（比如VS Code里在settings.json中添加"clangd.arguments": ["--compile-commands-dir=/your/project/path"]）。

• 第二步：让Clangd自动追踪文件变化
  主流编辑器的Clangd插件（比如VS Code的clangd、Neovim的lspconfig）默认都会监听文件修改，不需要你手动编译触发更新。如果你的提示没自动刷新，可以检查下插件设置：

  • 比如VS Code里确认clangd.autostart是开启状态；
  • Neovim里确保LSP服务正常运行，没有被禁用文件监听。
    另外，Clangd会自动缓存编译信息，当你新增文件、修改头文件或者调整编译参数后，它会重新分析相关代码，不用手动触发编译。

• 第三步：解决“未编译就显示错误”的异常情况
  你提到的“没编译就出现错误提示”，大概率是编译数据库的信息和实际代码不匹配：

  • 比如代码里引用了自定义头文件，但编译数据库里没加对应的-I参数，Clangd就会报“找不到头文件”的错误，这时候不用编译，只要修正编译数据库里的参数就行；
  • 如果是旧缓存导致的错误，可以重启Clangd服务（比如VS Code按Ctrl+Shift+P，选择“Restart Clangd”）来清空缓存，重新加载编译信息。

• 第四步：优化Clangd的提示体验
  你可以给Clangd加一些启动参数来提升体验：

  • 比如--header-insertion=never可以避免它自动给你插入头文件（如果不需要这个功能的话）；
  • --all-scopes-completion能让补全包含更多全局范围内的符号；
  • 加上--std=c++20这类参数，确保Clangd用正确的语言标准分析你的代码。

备注：内容来源于stack exchange，提问作者1385wz