在Neovim中通过Mason和null-ls配置Pylint无法加载包的求助

一、查看Pylint的包搜索路径 #

执行以下命令，输出Pylint当前使用的包搜索路径（即sys.path）：

pylint --init-hook="import sys; print('\n'.join(sys.path))" --disable=all dummy.py

说明：dummy.py可以是任意存在的Python文件，执行后会列出Pylint查找包的所有路径，对比pip3 show <package-name>输出的包安装位置，就能确认是否缺少目标路径。

二、优雅添加正确路径的方法 #

1. 配置Pylint配置文件 #

创建或修改项目根目录下的.pylintrc（或全局~/.pylintrc），在[MASTER]段添加：

init-hook='import sys; sys.path.append("/path/to/your/pip3-packages")'

若不确定pip3包的安装路径，可执行python3 -m site --user-site获取用户级site-packages路径，替换上述路径即可。

2. 对齐Pylint与Python3的运行环境 #

• 用pip3安装Pylint：执行pip3 install pylint，替代Mason安装的版本；
• 配置null-ls指向正确路径：在Neovim的null-ls配置中，指定系统pip3安装的Pylint路径（可通过which pylint查看）：

require("null-ls").setup({
    sources = {
        require("null-ls").builtins.diagnostics.pylint.with({
            command = "/usr/local/bin/pylint" -- 替换为你的pylint实际路径
        })
    }
})

3. 设置PYTHONPATH环境变量 #

在shell配置文件（~/.zshrc或~/.bashrc）中添加：

export PYTHONPATH="/path/to/your/site-packages:$PYTHONPATH"

保存后执行source ~/.zshrc（对应你的shell配置文件），Pylint和Python3会自动识别该路径下的包。

4. 结合虚拟环境使用 #

如果项目用虚拟环境，确保Neovim激活对应环境：

• 手动激活：在Neovim中执行:!source venv/bin/activate（venv为你的虚拟环境目录）；
• 自动激活：使用vim-python-virtualenv这类插件，让Neovim打开项目时自动激活虚拟环境，Pylint会自动识别环境内的包路径。

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