Neovim LSP中gopls重构代码动作（如函数提取）无法生效求助

问题背景 #

使用环境：Ubuntu 22.04.2 LTS + Neovim v0.8.3，通过mason插件配置gopls v0.13.1作为Go语言服务器。目前LSP基础功能（如变量重命名）正常，通过lua print(vim.inspect(vim.lsp.buf_get_clients()[1].server_capabilities))确认gopls支持refactor.extract等重构代码动作，但在可视化模式选中代码后，按<space>ca（映射了vim.lsp.buf.range_code_action）时，提示No code actions available，无法执行提取函数等操作。

已配置的LSP映射：

map('n', '<leader>ca', vim.lsp.buf.code_action)
map('v', '<leader>ca', vim.lsp.buf.range_code_action)
map('n', '<leader>rn', vim.lsp.buf.rename)

（leader键为空格）

解决步骤 #

• 确认选中代码的合法性
  gopls对提取函数的代码范围有严格要求，必须是完整、可独立运行的逻辑块，比如完整的循环体、if分支代码、连续的计算语句等。零散的变量声明、不完整的表达式无法触发提取动作，建议选中一段完整的业务逻辑再尝试。

• 修复可视化模式的代码动作映射
  Neovim v0.8.x的vim.lsp.buf.range_code_action可能存在参数传递问题，导致gopls无法正确识别选中范围。可以修改映射，手动指定过滤重构类动作：

  map('v', '<leader>ca', function()
    vim.lsp.buf.range_code_action(nil, {
      context = { only = { "refactor.extract" } }
    })
  end)
  

  这样会直接过滤出提取类的重构选项，提升识别准确率。

• 更新gopls到最新版本
  v0.13.1的gopls在代码范围识别上存在已知bug，通过mason更新到最新版可修复该问题：执行:MasonUpdate gopls命令完成更新。

• 检查gopls配置是否启用重构功能
  确保lspconfig的gopls配置中未禁用相关能力，示例配置如下：

  require('lspconfig').gopls.setup({
    settings = {
      gopls = {
        analyses = {
          unusedparams = true,
        },
        staticcheck = true,
        experimentalPostfixCompletions = true,
        gofumpt = true,
      },
    },
  })
  

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