让 Neovim 的 clang-tidy 诊断和命令行完全一致

问题

在 .clang-tidy 里配置了 Checks，Neovim（LazyVim + clangd）里却看不到对应的警告。加了 -llvmlibc-implementation-in-namespace 想禁用一个检查，nvim 里照样报警告。命令行 clang-tidy 工具的输出和 nvim 里的诊断永远对不上。

根因：四个独立的坑

坑一：clangd 和 clang-tidy 是两个世界

很多人以为 clangd 会自动读 .clang-tidy，实际上它们是完全独立的两套系统：

复制代码

命令行 clang-tidy ──读取──▶ .clang-tidy (Checks 列表)
                              │
clangd 内嵌 clang-tidy ──✗───┘  （完全不读！）
                  ──读取──▶ .clangd (Add / Remove)

clangd 内嵌了一个精简版 clang-tidy，但检查列表完全由 .clangd 的 Add / Remove 决定 ，.clang-tidy 的 Checks 对它无效。

更致命的是，clangd 为了性能硬编码跳过了一批高成本检查（misc-include-cleaner、misc-const-correctness 等），你怎么配置都没用。想获得和命令行 clang-tidy 一致的结果，必须绕过 clangd。

坑二：`ClangTidy: {}` 是禁用而不是"用默认值"

yaml 复制代码

# ✗ 错误理解：空对象 = "不干预，让 clangd 自己读 .clang-tidy"
Diagnostics:
  ClangTidy: {}

# ✓ 实际语义：空对象 = "禁用内置 clang-tidy"

ClangTidy: {} 在 clangd 里明确表示关闭 clang-tidy 检查。不写 ClangTidy 块也是关闭。必须显式配置 Add 才能激活，但即使激活了也见坑一。

坑三：nvim-lint 的 Windows 路径 parser bug

既然 clangd 不可靠，改用 nvim-lint（LazyVim 内置的异步 lint 框架）直接调系统 clang-tidy.exe。结果配好了还是没有诊断输出。

nvim-lint 内置的 clangtidy parser 用了这个 pattern：

lua 复制代码

local pattern = [=[([^:]*):(%d+):(%d+): (%w+): ([^[]+) %[(.*)%]]=]

[^:]* 匹配"第一个冒号之前的所有内容"作为文件路径。Unix 上没问题：

复制代码

/path/to/file.cpp:79:12: warning: ...
└──────────────┘  第一个 : 分隔，路径完整

Windows 上直接炸：

复制代码

D:\path\to\file.cpp:79:12: warning: ...
└┘                  第一个 : --- parser 把 D 当文件名，\path\... 当行号
                    → 匹配失败 → 所有诊断被静默丢弃

坑在 Windows 路径的驱动器号 D: 里也带冒号。修复：把 [^:]* 换成 .+，利用 Lua pattern 的贪婪匹配 + 回退机制自动越过驱动器号冒号：

lua 复制代码

local pattern = [=[(.+):(%d+):(%d+): (%w+): ([^[]+) %[(.*)%]]=]

坑四：LazyVim 的 config 覆盖问题

lazy.nvim 的规则：同一插件的多个 spec 中，只有最后一个 config 函数生效 。前面所有 spec 的 config 都被覆盖，不会执行。

LazyVim 内置了一个 nvim-lint spec：

lua 复制代码

-- LazyVim 内置 spec
{
  "mfussenegger/nvim-lint",
  config = function(_, opts)
    -- 设置 linters_by_ft
    -- 创建 augroup "nvim-lint"
    -- 注册 BufWritePost / BufReadPost / InsertLeave 的 autocmd
    -- 实现 debounce 触发 lint
  end,
}

我以为追加一个自己的 spec，只写 parser 修复就行：

lua 复制代码

-- 我的 spec（❌ 错误做法：自己定义了 config）
{
  "mfussenegger/nvim-lint",
  config = function()
    -- 只修改了 clangtidy parser
    lint.linters.clangtidy.parser = ...
  end,
}

结果我的 config 把 LazyVim 的 config 完全覆盖了。LazyVim 负责创建 augroup 和 autocmd 的逻辑全被跳过------lint 从来就没被触发过，parser 修得再好也是空转。

正确的做法 要么只用 opts 不做 config，要么在自己的 config 里把 LazyVim 的初始化逻辑原样抄过来。

最终方案

第一步：关掉 clangd 内置 clang-tidy

.clangd：

yaml 复制代码

CompileFlags:
  CompilationDatabase: out
  Add:
    - -std=c++17

Diagnostics:
  # 禁用 clangd 内置 clang-tidy，交给 nvim-lint + 外部 clang-tidy
  ClangTidy: {}

clangd 回归本职工作：语法报错、代码补全、跳转。clang-tidy 检查全部交给外部工具。

第二步：配置 nvim-lint

~/.config/nvim/lua/plugins/linting.lua：

lua 复制代码

return {
  "mfussenegger/nvim-lint",
  opts = {
    linters_by_ft = {
      cpp = { "clangtidy" },
    },
    events = { "BufWritePost", "BufReadPost", "InsertLeave" },
  },
  config = function(_, opts)
    local lint = require("lint")
    local root = vim.fs.root(0, {
      "compile_commands.json",
      ".clang-tidy",
      "CMakeLists.txt",
    }) or vim.fn.getcwd()

    -- 修复 Windows 路径 parser（坑三）
    local pattern = [=[(.+):(%d+):(%d+): (%w+): ([^[]+) %[(.*)%]]=]
    local groups = { "file", "lnum", "col", "severity", "message", "code" }
    local severity_map = {
      ["error"] = vim.diagnostic.severity.ERROR,
      ["warning"] = vim.diagnostic.severity.WARN,
      ["information"] = vim.diagnostic.severity.INFO,
      ["hint"] = vim.diagnostic.severity.HINT,
      ["note"] = vim.diagnostic.severity.HINT,
    }

    lint.linters.clangtidy.cmd = "clang-tidy"  -- 依赖 PATH，跨平台
    lint.linters.clangtidy.args = { "--quiet", "-p", root }
    lint.linters.clangtidy.parser = require("lint.parser").from_pattern(
      pattern, groups, severity_map, { ["source"] = "clang-tidy" }
    )

    -- LazyVim 的初始化逻辑（坑四：自己 config 必须自己补齐）
    lint.linters_by_ft = opts.linters_by_ft

    local function debounce(ms, fn)
      local timer = vim.uv.new_timer()
      return function(...)
        local argv = { ... }
        timer:start(ms, 0, function()
          timer:stop()
          vim.schedule_wrap(fn)(unpack(argv))
        end)
      end
    end

    local function do_lint()
      local names = lint._resolve_linter_by_ft(vim.bo.filetype)
      names = vim.list_extend({}, names)
      if #names == 0 then
        vim.list_extend(names, lint.linters_by_ft["_"] or {})
      end
      vim.list_extend(names, lint.linters_by_ft["*"] or {})
      local ctx = { filename = vim.api.nvim_buf_get_name(0) }
      ctx.dirname = vim.fn.fnamemodify(ctx.filename, ":h")
      names = vim.tbl_filter(function(name)
        local linter = lint.linters[name]
        return linter
          and not (
            type(linter) == "table"
            and linter.condition
            and not linter.condition(ctx)
          )
      end, names)
      if #names > 0 then
        lint.try_lint(names)
      end
    end

    vim.api.nvim_create_autocmd(opts.events, {
      group = vim.api.nvim_create_augroup("nvim-lint", { clear = true }),
      callback = debounce(100, do_lint),
    })
  end,
}

第三步：保持 `.clang-tidy` 不变

.clang-tidy 只管命令行 clang-tidy 工具和自己的脚本，格式不变：

yaml 复制代码

Checks: >
  google-*,
  readability-*,
  performance-*,
  modernize-*,
  bugprone-*,
  misc-*,
  -bugprone-easily-swappable-parameters,
  ...

最终架构

复制代码

                      ┌─── 语法报错、补全、跳转
nvim ──LSP──▶ clangd ─┤
                      └─── ClangTidy: {}（不插手）
                      ┌─── 调用系统 clang-tidy.exe
      ──lint──▶ nvim-lint ─┤
                      └─── 读取 .clang-tidy Checks
                      └─── 和命令行脚本完全一致 ✓

两个工具各司其职，diagnostics 分别来自两个 channel------LSP 的语法诊断和 lint 的 clang-tidy 诊断------互不干扰，结果和命令行完全对齐。

跨平台注意事项

cmd = "clang-tidy"：依赖 PATH，确保安装了 LLVM 并把 clang-tidy 加入 PATH
vim.fs.root：自动从当前文件向上查找项目根目录（识别 compile_commands.json / .clang-tidy / CMakeLists.txt）
parser 修复（. → .+" 贪婪匹配）在 Windows 和 Unix 路径格式下都正常工作

唯一的前提条件是系统安装了 LLVM/clang-tidy，其他零配置跨平台迁移。

让 Neovim 的 clang-tidy 诊断和命令行完全一致