一、LSP选型建议：直接冲clangd就对了 #

作为常年用Neovim撸C++的老玩家，给你掏实底：

• clangd：LLVM官方亲儿子，更新频率拉满，C20、C23这些新标准的支持跟进得特别快，和Clang工具链集成度也高。别担心你用的是Homebrew的GCC——只要项目能生成正确的compile_commands.json，clangd完全能识别GCC的编译选项，完美适配你的开发环境。而且Neovim官方的LSP客户端nvim-lspconfig对clangd的支持是最成熟的，踩坑概率极低。
• ccls：它是基于旧版Clang fork出来的LSP，功能其实也全，但近几年维护活跃度明显下降，新的C++标准特性支持不如clangd及时，除非你有特殊的历史项目依赖，否则真没必要选它。

综合来看，选clangd省心又靠谱，绝对是新手最优解。

二、M2 Mac上的clangd配置全步骤 #

1. 安装clangd #

你已经在用Homebrew了，终端直接跑：

brew install clangd

装完输clangd --version验证一下，能输出版本号就说明没问题。

2. 配置Neovim的LSP基础环境 #

首先得装nvim-lspconfig——这是官方维护的LSP配置集合，新手友好度拉满。如果你用现在Neovim圈最火的lazy.nvim包管理器，在init.lua里加这段来安装：

require("lazy").setup({
  {
    'neovim/nvim-lspconfig',
    config = function()
      -- 后续LSP配置都写在这里
    end
  }
})

要是你用的是packer.nvim，配置逻辑类似，核心就是先把nvim-lspconfig装上就行。

3. 适配GCC项目的clangd配置 #

在nvim-lspconfig的config函数里，加上clangd的专属配置：

local lspconfig = require('lspconfig')

lspconfig.clangd.setup({
  cmd = {
    "clangd",
    -- 关键：告诉clangd你用的是Homebrew的GCC，替换成你实际的版本，比如gcc-13、g++-13
    "--query-driver=/opt/homebrew/bin/gcc-*,/opt/homebrew/bin/g++-*",
    -- 下面是新手友好的实用选项，直接抄就行
    "--background-index",
    "--clang-tidy",
    "--completion-style=detailed",
    "--header-insertion=iwyu",
  },
  on_attach = function(client, bufnr)
    -- 给你加几个新手常用的快捷键，按需调整
    local opts = { buffer = bufnr, noremap = true, silent = true }
    vim.keymap.set('n', 'gd', vim.lsp.buf.definition, opts) -- 跳转到定义
    vim.keymap.set('n', 'gr', vim.lsp.buf.references, opts) -- 查看引用
    vim.keymap.set('n', 'K', vim.lsp.buf.hover, opts) -- 悬停看提示
    vim.keymap.set('n', '<space>rn', vim.lsp.buf.rename, opts) -- 批量重命名
  end,
})

4. 生成关键文件compile_commands.json #

clangd全靠这个文件识别你的项目编译参数，不同项目类型生成方式不一样：

• CMake项目：编译前加个参数就行

  cmake -S . -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
  

  然后把生成的文件软链到项目根目录：

  ln -s build/compile_commands.json .
  

• Makefile项目：用bear工具生成，先装bear：

  brew install bear
  

  之后代替直接跑make，执行：

  bear -- make
  

  项目根目录就会自动生成compile_commands.json了。

5. 验证配置 #

打开你的C++源文件，等个几秒让clangd初始化完成，试试按gd跳转到函数定义，或者悬停在变量上看提示——如果能正常显示，就说明配置成了！

最后补个小tip：要是遇到clangd找不到头文件的问题，先检查compile_commands.json里的参数是不是和你用GCC编译时的一致，或者在clangd的cmd里加--include-directory=/你的头文件路径就行，大多都是这个小问题。