求助：gopls LSP打开.go文件无法自动加载，手动启动正常

以下是针对你的问题的具体排查和解决步骤：

1. 检查PATH环境变量 #

你手动指定Mason安装的gopls路径能启动，但配置里用{"gopls"}不行，核心原因是Neovim无法在系统PATH中找到gopls命令。Mason安装的工具默认存放在~/.local/share/nvim/mason/bin/，如果这个路径不在你的系统PATH里，nvim就找不到gopls。

解决方法：

• 在你的shell配置文件（如~/.bashrc、~/.zshrc）中添加以下内容：

  export PATH="$HOME/.local/share/nvim/mason/bin:$PATH"
  

• 执行source ~/.bashrc（对应你的shell配置文件）让PATH生效，之后重启Neovim即可。

2. 直接在配置中指定gopls绝对路径 #

如果不想修改系统PATH，可以直接在lspconfig配置里写死gopls的绝对路径，和你手动启动时用的路径一致：

lspconfig.gopls.setup {
  on_attach = on_attach,
  on_init = on_init,
  capabilities = capabilities,
  -- 替换为你实际的gopls路径
  cmd = { "/home/user/.local/share/nvim/mason/bin/gopls" },
  filetypes = {"go", "gomod", "gowork", "gotmpl"},
  root_dir = util.root_pattern("go.work", "go.mod", ".git"),
  settings = {
    gopls = {
      completeUnimported = true,
      usePlaceHolders = true,
    }
  }
}

保存配置后重启Neovim，打开.go文件再执行LspInfo就能看到gopls正常附着。

3. 验证root_dir匹配规则 #

你的配置中root_dir是基于go.work、go.mod或.git目录识别项目根的，如果当前打开的.go文件不在这些文件所在的目录层级下，lspconfig不会自动启动gopls。

解决方法：

• 确保你打开的.go文件属于有go.mod/go.work/.git的项目根目录；
• 或者调整root_pattern规则，比如加上当前目录作为 fallback：

  root_dir = util.root_pattern("go.work", "go.mod", ".git", "."),
  

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