Windows下基于kickstart.nvim配置clangd LSP的问题求助

环境信息 #

• 系统：Windows
• 编译器：GCC（MinGW64）
• 终端：Microsoft Store安装的Microsoft Terminal（使用cmd）
• Neovim配置：基于kickstart.nvim（lazy.nvim）

问题描述 #

目前除clangd LSP外，其他Neovim功能均正常工作。仅取消init.lua中的clangd={}注释、通过Mason安装clangd后，LSP无法找到<iostream>、<bits/stdc++.h>等C++标准头文件，导致代码提示和语法检查失效。希望保持Windows原生环境，不使用WSL以无缝编辑本地文件。

尝试过的操作 #

手动在终端设置环境变量CPLUS_INCLUDE_PATH，指向MinGW的C++头文件目录：

set CPLUS_INCLUDE_PATH=C:\ProgramData\mingw64\mingw64\lib\gcc\x86_64-w64-mingw32\13.2.0;C:\ProgramData\mingw64\mingw64\lib\gcc\x86_64-w64-mingw32\13.2.0\include;C:\ProgramData\mingw64\mingw64\lib\gcc\x86_64-w64-mingw32\13.2.0\include\c++;C:\ProgramData\mingw64\mingw64\lib\gcc\x86_64-w64-mingw32\13.2.0\include\c++\x86_64-w64-mingw32

设置后出现多种错误，例如：

clangd初始化失败，无法解析指定的头文件路径；部分路径被识别为无效格式，导致标准库索引失败

相关配置代码（kickstart.nvim的init.lua片段） #

local capabilities = vim.lsp.protocol.make_client_capabilities()
capabilities = vim.tbl_deep_extend('force', capabilities, require('cmp_nvim_lsp').default_capabilities())

-- Enable the following language servers
--  Feel free to add/remove any LSPs that you want here. They will automatically be installed.
--
--  Add any additional override configuration in the following tables. Available keys are:
--  - cmd (table): Override the default command used to start the server
--  - filetypes (table): Override the default list of associated filetypes for the server
--  - capabilities (table): Override fields in capabilities. Can be used to disable certain LSP features.
--  - settings (table): Override the default settings passed when initializing the server.
--        For example, to see the options for `lua_ls`, you could go to: https://luals.github.io/wiki/settings/
local servers = {
  clangd = {},
  -- gopls = {},
  pyright = {},
  -- rust_analyzer = {},
  -- ... etc. See `:help lspconfig-all` for a list of all the pre-configured LSPs
  --
  -- Some languages (like typescript) have entire language plugins that can be useful:
  --    https://github.com/pmizio/typescript-tools.nvim
  --
  -- But for many setups, the LSP (`ts_ls`) will work just fine
  -- ts_ls = {},
  --

  lua_ls = {
    -- cmd = {...},
    -- filetypes = { ...},
    -- capabilities = {},
    settings = {
      Lua = {
        completion = {
          callSnippet = 'Replace',
        },
        -- You can toggle below to ignore Lua_LS's noisy `missing-fields` warnings
        -- diagnostics = { disable = { 'missing-fields' } },
      },
    },
  },
}

-- Ensure the servers and tools above are installed
--  To check the current status of installed tools and/or manually install
--  other tools, you can run
--    :Mason
--
--  You can press `g?` for help in this menu.
require('mason').setup()

-- You can add other tools here that you want Mason to install
-- for you, so that they are available from within Neovim.
local ensure_installed = vim.tbl_keys(servers or {})
vim.list_extend(ensure_installed, {
  'stylua', -- Used to format Lua code
})
require('mason-tool-installer').setup { ensure_installed = ensure_installed }

require('mason-lspconfig').setup {
  handlers = {
    function(server_name)
      local server = servers[server_name] or {}
      -- This handles overriding only values explicitly passed
      -- by the server configuration above. Useful when disabling
      -- certain features of an LSP (for example, turning off formatting for ts_ls)
      server.capabilities = vim.tbl_deep_extend('force', {}, capabilities, server.capabilities or {})
      require('lspconfig')[server_name].setup(server)
    end,
  },
}

解决方案 #

直接在clangd的配置中添加启动参数，让clangd正确识别MinGW的编译环境：

clangd = {
  cmd = {
    "clangd",
    "--query-driver=C:\\ProgramData\\mingw64\\mingw64\\bin\\g++.exe",
    "--completion-style=detailed",
    "--header-insertion=iwyu",
  },
},

如果仍有头文件识别问题，可以手动补充包含路径：

clangd = {
  cmd = {
    "clangd",
    "--query-driver=C:\\ProgramData\\mingw64\\mingw64\\bin\\g++.exe",
    "--include-directory=C:\\ProgramData\\mingw64\\mingw64\\lib\\gcc\\x86_64-w64-mingw32\\13.2.0\\include",
    "--include-directory=C:\\ProgramData\\mingw64\\mingw64\\lib\\gcc\\x86_64-w64-mingw32\\13.2.0\\include\\c++",
    "--include-directory=C:\\ProgramData\\mingw64\\mingw64\\lib\\gcc\\x86_64-w64-mingw32\\13.2.0\\include\\c++\\x86_64-w64-mingw32",
    "--completion-style=detailed",
  },
},

同时确保MinGW的bin目录（C:\ProgramData\mingw64\mingw64\bin）已添加到系统PATH环境变量中，避免clangd找不到编译驱动。

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