Neovim配置clangd：悬停显示定义注释、gd跳转至定义方法

针对你用Neovim 0.9 + clangd阅读Linux内核代码时遇到的跳转和悬停问题，直接通过clangd的LSP配置就能解决：

1. 让gd跳转到函数定义而非声明 #

在你的Neovim LSP配置中，给clangd添加以下参数和设置，确保它优先识别函数定义：

require('lspconfig').clangd.setup({
  cmd = {
    'clangd',
    '--compile-commands-dir=.', -- 指向compile_commands.json所在的内核源码根目录
    '--header-insertion=never', -- 关闭自动头文件插入，减少不必要的干扰
    -- 如果用交叉编译链，添加这行替换成你的工具链路径：
    -- '--query-driver=/usr/bin/arm-linux-gnueabihf-gcc',
  },
  settings = {
    clangd = {
      gotoDefinition = {
        fallback = true, -- 优先找定义，找不到才回退到声明
      },
      -- 给clangd补上内核编译的必要宏和头文件，避免解析错误
      fallbackFlags = {
        '-DKERNEL',
        '-include', 'linux/kconfig.h',
        '-include', 'linux/compiler_types.h',
      },
    },
  },
})

2. 让K键悬停显示定义处的注释 #

在上述clangd的settings里加上hover.preferDefinition配置，强制clangd优先拉取定义位置的注释：

settings = {
  clangd = {
    -- 保留上面的配置...
    hover = {
      preferDefinition = true, -- 悬停时优先展示定义处的注释
    },
  },
}

验证步骤 #

1. 保存配置后重启Neovim
2. 打开drivers/base/core.c，光标定位到device_create
3. 按K键，应该显示函数定义上方的文档注释
4. 按gd，直接跳转到core.c里的函数定义，不再跳转到device.h的声明

排查小贴士 #

如果配置后还是有问题，检查这几点：

• compile_commands.json是否正确生成，确认里面包含drivers/base/core.c的编译条目
• 内核源码是否已经完成配置（比如执行过make defconfig），clangd需要正确的编译上下文才能精准识别定义
• 升级clangd到16以上版本，旧版本对内核代码的语法支持可能不完善

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