求助：gopls在Neovim中通过lspconfig无法工作如何解决？

问题详情 #

• 环境：Neovim + lspconfig + gopls
• 异常现象：即便Go文件所在目录包含.git或go.mod，gopls仍无法对任何Go文件提供代码提示、诊断等服务
• 当前lspconfig配置：

lspconfig["gopls"].setup({
    capabilities = capabilities,
    on_attach = on_attach,
})

• 矛盾点：LspInfo显示gopls服务已正常启动，但日志中记录go_proxy=Off，与本地go env输出的实际值不符

排查修复步骤 #

1. 显式指定gopls的环境变量 #

在lspconfig配置中强制注入正确的GO_PROXY值，覆盖可能被Neovim或LSP客户端篡改的环境变量：

lspconfig["gopls"].setup({
    capabilities = capabilities,
    on_attach = on_attach,
    cmd_env = {
        GO_PROXY = "https://proxy.golang.org,direct" -- 替换为你本地`go env`输出的GO_PROXY值
    }
})

2. 检查gopls初始化日志 #

在Go文件中执行:LspLog打开详细日志，搜索以下关键词确认运行状态：

• initialized：确认gopls完成初始化流程
• workspace/didChangeConfiguration：检查配置是否正确传递给gopls
• 若日志出现no packages loaded，手动执行:GoMod tidy或:GoBuild触发模块加载

3. 验证on_attach函数是否异常 #

确保你的on_attach函数没有误禁用LSP核心功能，比如诊断、代码提示：

-- 参考正常的on_attach模板，对比排查问题
local on_attach = function(client, bufnr)
    local bufopts = { noremap=true, silent=true, buffer=bufnr }
    vim.keymap.set('n', 'gD', vim.lsp.buf.declaration, bufopts)
    vim.keymap.set('n', 'gd', vim.lsp.buf.definition, bufopts)
    vim.keymap.set('n', 'K', vim.lsp.buf.hover, bufopts)
    -- 确保未禁用诊断
    vim.diagnostic.enable(bufnr)
end

4. 重新安装并验证gopls版本 #

执行命令更新gopls到最新稳定版：

go install golang.org/x/tools/gopls@latest

然后在Neovim中执行:checkhealth lsp，确认gopls路径正确且版本兼容当前Go版本

5. 确认Neovim工作目录 #

打开Go文件时，确保Neovim的工作目录是项目根目录（包含go.mod的目录），可通过:pwd查看，若不符则执行:cd /path/to/your/project切换目录

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