配置clangd适配C11：解决macOS+Emacs+eglot下C++补全异常

一、配置clangd适配C11 #

1. 项目级配置（推荐） #

clangd依赖compile_commands.json获取编译参数，确保文件中明确指定C11标准：

• 手动编写compile_commands.json（适用于非CMake项目）：

[
  {
    "directory": "/你的项目路径",
    "command": "clang -std=c11 -Wall -c main.c",
    "file": "main.c"
  }
]

将该文件放在项目根目录即可。

• CMake项目自动生成：
  在CMakeLists.txt中添加：

set(CMAKE_C_STANDARD 11)
set(CMAKE_C_STANDARD_REQUIRED ON)

执行编译命令时导出编译数据库：

cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON ..

最后把生成的compile_commands.json软链到项目根目录：

ln -s build/compile_commands.json .

2. Emacs/Eglot全局配置 #

如果不想每个项目单独配置，可在Emacs配置中给C模式绑定clangd启动参数：

(add-hook 'c-mode-hook
          (lambda ()
            (setq eglot-workspace-configuration
                  '((:clangd . ((fallbackFlags . ["-std=c11"])))))))

打开.c文件时，Eglot会自动给clangd传递-std=c11参数，强制以C11模式处理。

二、检查使用方式是否有误 #

• 确认文件后缀为.c：若后缀是.cpp/.cc，clangd会默认以C++模式解析，务必用.c后缀保存C代码。
• 避免包含C头文件：若C代码中意外引入<iostream>等C专属头文件，clangd会切换到C++模式，检查代码中的include语句。
• 排查项目中的.clangd配置文件：若项目根目录存在.clangd文件，检查是否有强制启用C++的配置，修改为：

CompileFlags:
  Add: [-std=c11]

三、是否需要更换语言服务器 #

不需要。clangd是LLVM官方维护的语言服务器，对C标准支持完善、更新及时且兼容性好。除非遇到clangd无法解决的特殊场景，否则优先通过配置解决问题，无需更换为ccls等其他服务器。

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