如何让clangd识别编译器传入的自定义宏定义

clangd默认不会读取你的构建脚本里的编译参数，所以不知道你编译时定义的CLIENT、SERVER宏，只要把这些宏定义告知clangd就能解决问题，可选择以下几种方案：

方案1：导出编译命令数据库（最推荐） #

主流构建工具都支持导出compile_commands.json文件，这个文件会记录每个源码文件对应的完整编译参数，clangd会自动读取该文件的内容识别宏定义：

• CMake：编译时追加-DCMAKE_EXPORT_COMPILE_COMMANDS=ON参数，生成的compile_commands.json会放在构建目录下，把它软链或者复制到项目根目录即可
• Meson：构建时会自动生成该文件，直接从构建目录复制到项目根目录即可
• Make、Ninja等其他工具：可以用bear工具在编译时拦截编译命令生成该文件，执行bear -- make（把make替换成你实际的编译命令）即可

如果你的客户端、服务端是两个独立的构建目标，主流编辑器的clangd插件都支持切换当前文件对应的编译目标，选中对应目标后宏的取值会自动同步。

方案2：手动编写项目级clangd配置 #

如果不想生成编译命令数据库，可以直接在项目根目录新建.clangd配置文件手动指定宏定义。
如果客户端、服务端源码分路径存放，可以按路径匹配自动切换宏值：

# 匹配客户端源码路径，自动设客户端宏值
If:
  PathMatch: .*client/.*
CompileFlags:
  Add:
    - -DCLIENT=1
    - -DSERVER=0
---
# 匹配服务端源码路径，自动设服务端宏值
If:
  PathMatch: .*server/.*
CompileFlags:
  Add:
    - -DCLIENT=0
    - -DSERVER=1

如果源码没有分路径，也可以直接写固定的宏值，需要切换的时候手动修改配置文件即可，clangd会自动热重载配置。

方案3：配置clangd启动参数（临时方案） #

如果只是临时测试，不想修改项目配置，可以在编辑器的clangd插件设置里，给clangd的启动参数追加编译标记，比如要调试客户端就加--compile-flags=-DCLIENT=1 -DSERVER=0，切换宏值需要重启clangd进程。

注意：不推荐通过屏蔽未定义变量报错的方式解决问题，会导致真实的语法错误也被过滤。

内容的提问来源于stack exchange，提问作者Duddino