Cursor 里 C++ 头文件报错的原因与解决：
使用 compile_commands.json
今天在 chat-server-cpp 项目里遇到一个常见问题：CMake 能正常编译，但编辑器里一堆头文件红线，导致跳转、补全和诊断全是假的错误。本文记录问题原因与解决过程。
现象
- 终端 cmake + make 没问题
- Cursor/clangd 里却提示 #include 找不到、类型未定义
- 实际上是 编辑器没有拿到编译参数
根因
CMake 编译时会给每个源文件传入大量参数：
- -I 头文件路径
- 宏定义
- C++ 标准选项
- 第三方库路径
而编辑器默认不知道这些参数，只能按系统默认路径解析，于是报错。
解决核心：让编辑器使用真实编译参数。
解决方案
让 CMake 生成 compile_commands.json，并让 Cursor/clangd 读取它。
1）生成 compile_commands.json
cmake -S 你的项目路径 \
-B 你的项目构建路径 \
-DCMAKE_EXPORT_COMPILE_COMMANDS=ON
生成位置：
项目构建路径/compile_commands.json
2）放到项目根目录（软连接）
ln -sf 项目构建路径/compile_commands.json \
你想放入的路径
3）重载 Cursor
- 关闭并重开窗口
- 或执行 “Reload Window”
如果还是没生效，可以在 clangd 参数里显式指定：
--compile-commands-dir=/home/qzr/gitee/chat-server-cpp/server/build
原理小结
compile_commands.json 本质是 每个源文件的完整编译命令清单。
clangd 读取后，就能“像真实编译器一样”解析项目，因此红线消失、跳转补全恢复。
)