VS Code中Pylint报E0401但Python运行正常的模块导入问题咨询

首先，咱们先明确问题的核心原因：Python解释器和Pylint的模块搜索路径（sys.path）不一样。

为什么会出现这种矛盾？ #

当你直接运行python .\subdir1\module3.py时，Python会自动把当前脚本所在的目录（也就是subdir1/）添加到sys.path的最前面。这时候import module4就相当于从subdir1/里找文件，自然能找到同目录的module4.py，所以运行完全没问题。

但VS Code里的Pylint是基于你打开的项目根目录（也就是dir/）来做代码分析的，它的sys.path默认只包含项目根目录。对Pylint来说，module4并不是顶级模块——它的完整路径应该是subdir1.module4，所以直接写import module4会被判定为找不到模块，抛出E0401错误。

几种可行的解决方案 #

1. 使用相对导入（最符合Python包规范） #

在module3.py里改用相对导入语法，明确从当前目录导入module4：

from . import module4
print(module4.msg)

不过要注意：相对导入只能在包内部使用，这意味着你不能再直接运行module3.py了，得从项目根目录dir/的父目录，用包的方式运行：

python -m dir.subdir1.module3

这种方式能让Python把整个dir当作一个包来处理，既符合规范，也能让Pylint正确识别模块关系。

2. 修改Pylint配置，添加模块搜索路径 #

如果你还是想保留直接运行module3.py的方式，可以修改Pylint的配置，让它把subdir1/加入搜索路径：

• 在项目根目录dir/下创建一个.pylintrc文件，添加以下内容：

[MASTER]
init-hook='import sys, os; sys.path.insert(0, os.path.join(os.path.dirname(__file__), "subdir1"))'

这样Pylint在分析代码时，会自动把subdir1/加到sys.path里，就能识别module4了。

或者在VS Code的设置里直接配置：
打开设置（快捷键Ctrl+,），搜索python.linting.pylintArgs，添加参数：

--init-hook="import sys, os; sys.path.insert(0, os.path.join(os.path.dirname(__file__), 'subdir1'))"

3. 使用绝对导入 #

把dir/目录添加到Python的sys.path中，然后在module3.py里用绝对导入：

from subdir1 import module4
print(module4.msg)

要实现这个，你可以：

• 临时设置环境变量PYTHONPATH（Windows：set PYTHONPATH=.\dir；Linux/macOS：export PYTHONPATH=./dir），然后运行python .\subdir1\module3.py
• 或者从dir/的父目录，用包的方式运行：python -m dir.subdir1.module3

这样不管是Python运行还是Pylint分析，都能正确找到module4。

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