如何在Neovim+LSP环境下导入光标处的Python模块符号

以下是几个可行的实现方案，按优先级排序：

1. 正确配置Pyright语言服务器 #

Pyright本身支持通过代码操作提供自动导入建议，大概率是你的配置未开启相关选项。在lspconfig的Pyright配置中添加以下设置：

require('lspconfig').pyright.setup({
  settings = {
    python = {
      analysis = {
        autoImportCompletions = true,
        autoSearchPaths = true,
        useLibraryCodeForTypes = true,
        diagnosticMode = "workspace", -- 确保LSP分析整个工作区
        typeCheckingMode = "basic" -- 基础类型检查足以触发导入建议
      }
    }
  }
})

配置完成后重启Neovim，将光标放在未导入的符号（比如Path）上，触发代码操作（默认可通过vim.lsp.buf.code_action()，建议绑定快捷键如<leader>ca），此时应该会出现Import "pathlib.Path"这类选项。

2. 用Ruff LSP实现导入修复 #

Ruff LSP的代码修复功能支持自动补全导入，需要先在项目的pyproject.toml中开启相关规则：

[tool.ruff.lint]
select = ["F401", "F403", "F405"] # 覆盖未使用/缺失导入的规则
fix = true # 允许自动修复

然后配置Ruff LSP：

require('lspconfig').ruff_lsp.setup({
  init_options = {
    settings = {
      args = {}
    }
  }
})

触发代码操作后，Ruff会提供Fix import的选项，直接补全缺失的导入语句。

3. 使用专门的自动导入插件 #

如果上述LSP方案仍不生效，可以尝试专门的自动导入插件，比如autoimport.nvim，它能主动检测未导入的符号并提供导入选项：

require('autoimport').setup({
  enable = true,
  import_on_completion = true, -- 补全时自动提示导入
  disable_virtual_text = false -- 显示虚拟文本提示缺失导入
})

该插件会在你输入未导入的符号时，自动弹出导入建议，无需手动触发代码操作。

注意事项 #

• 确保打开Neovim时处于项目根目录，让LSP完成工作区索引；
• 检查快捷键绑定是否正确，比如添加：

vim.keymap.set('n', '<leader>ca', vim.lsp.buf.code_action, { desc = '触发代码操作' })

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