Neovim无法检测Django包：报‘Unable to import 'django.*'’错误求助

先做排查，定位问题根源 #

• 核对Neovim与外部的Python路径是否一致

  1. 外部终端执行 which python3 或 which python，记下路径
  2. 打开Neovim，执行 :checkhealth python，查看输出中的Python解释器路径，和外部的对比
  3. 也可以在Neovim里执行 :!python -c "import django; print(django.__file__)"，如果报错，说明当前Neovim用的Python环境没装Django

• 检查LSP（如Pyright、Pylance）的配置
  多数情况是LSP未指向正确环境导致无法识别Django包，查看你使用的LSP配置文件，确认pythonPath是否指向安装了Django的环境。

具体解决方法 #

方法1：启动Neovim时激活目标虚拟环境 #

如果用venv管理环境，先在终端激活环境再启动Neovim：

source /path/to/your/venv/bin/activate && nvim

如果用Poetry，直接用以下命令启动：

poetry run nvim

方法2：强制指定Neovim的Python解释器 #

在你的Neovim配置文件（init.lua或init.vim）里添加以下配置，指向安装了Django的Python路径：

• Lua格式：

vim.g.python3_host_prog = "/path/to/your/venv/bin/python"

• Vimscript格式：

let g:python3_host_prog = '/path/to/your/venv/bin/python'

方法3：配置LSP指向正确的Python环境 #

以Pyright为例，在LSP配置中明确指定Python路径：

require('lspconfig').pyright.setup({
  settings = {
    python = {
      pythonPath = "/path/to/your/venv/bin/python",
      analysis = {
        autoSearchPaths = true,
        useLibraryCodeForTypes = true
      }
    }
  }
})

如果用Coc.nvim，在coc-settings.json里添加：

{
  "python.pythonPath": "/path/to/your/venv/bin/python"
}

方法4：确保Django安装在Neovim使用的环境中 #

如果排查后发现Neovim用的环境确实没装Django，直接执行以下命令安装：

/path/to/neovim/python -m pip install django

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