pre-commit执行pylint报E0401无法导入项目模块该如何解决

报错的根本原因是：pre-commit 执行本地 pylint 钩子时，Python 解释器的模块搜索路径没有包含项目根目录，因此无法识别 dags、tests 这类顶层包。

解决方案 #

方法1：修改pre-commit钩子配置（最快生效） #

直接调整 .pre-commit-config.yaml 中 pylint 本地钩子的 entry 字段，主动将当前项目根目录加入模块搜索路径：

repos:
  # 其余原有配置保持不变
  - repo: local
    hooks:
      - id: pylint
        name: pylint
        entry: pylint --init-hook "import sys; sys.path.insert(0, '.')"
        language: python
        types: [python]

修改完成后执行 pre-commit run --all-files pylint 验证即可。

方法2：通过pylint配置文件统一管理（适合多场景调用pylint的项目） #

如果项目需要在多个场景下调用pylint，可以通过统一配置文件实现规则复用：

1. 项目根目录下生成pylint配置文件（已有可跳过）：

pylint --generate-rcfile > .pylintrc

2. 打开 .pylintrc，在 [MASTER] 配置块下添加如下规则：

[MASTER]
init-hook=import sys; sys.path.insert(0, '.')

配置完成后无需修改pre-commit的钩子参数，pylint运行时会自动读取配置文件生效。

可选补充配置 #

如果项目依赖安装在指定虚拟环境中，可在pylint钩子配置中添加 language: system，直接调用本地环境的pylint，避免pre-commit默认隔离环境导致的依赖找不到问题。

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