Clangd编辑C文件时自动插入C++头文件，如何禁用该行为？

问题描述 #

编辑.c文件时，clangd自动插入头文件时会选择C++风格的版本（比如ctime），而非C风格的time.h，需要调整配置禁用这一行为。

当前Nvim Lspconfig配置 #

["clangd"] = function()
    local lspconfig = require("lspconfig")
    lspconfig.clangd.setup {
        cmd = { "clangd", 
            "--background-index", 
            "--completion-style=detailed", 
            "--header-insertion=iwyu", 
            "--log=verbose" 
        },
        filetypes = { "c" },
        root_dir = function()
          return vim.loop.cwd()
        end,
    }
end,

解决方案 #

问题根源在于--header-insertion=iwyu参数：IWYU（Include What You Use）工具默认倾向于C++风格头文件。可以通过以下几种方式调整：

• 移除或替换IWYU参数
  把--header-insertion=iwyu从cmd中删除，或者改为--header-insertion=never（完全禁用自动头文件插入）。修改后的cmd配置示例：

  cmd = { "clangd", 
      "--background-index", 
      "--completion-style=detailed", 
      "--log=verbose" 
  },
  

  移除该参数后，clangd会使用默认逻辑，针对C文件优先选择C风格头文件。

• 指定C编译器路径
  添加--query-driver参数明确告诉clangd使用的C编译器，让它根据环境适配头文件选择。例如：

  cmd = { "clangd", 
      "--background-index", 
      "--completion-style=detailed", 
      "--log=verbose",
      "--query-driver=/usr/bin/gcc,/usr/bin/clang"
  },
  

• 完善项目编译配置
  如果项目有compile_commands.json或Makefile，确保其中指定了C编译标准（如-std=c99），clangd会读取这些配置自动匹配正确的头文件类型。

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