Python项目Makefile执行lint目标时触发Error 12求助排查

1. 确认pylint实际退出码 #

修改Makefile的lint目标，在pylint命令后添加退出码打印，明确返回值：

lint:
    pylint -j0 --ignore=src/_playground --extension-pkg-whitelist=gurobipy src/; echo "Pylint exit code: $$?"
    mypy --exclude src/_playground/ src/
    flake8 --exclude=src/_playground src/

执行make lint，查看打印的退出码是否确实为12，同时确认pylint输出的检查结果是否包含警告（对应返回码4）或重构建议（对应返回码8）——12是这两个码的按位或结果。

2. 对比Make与终端的执行环境差异 #

Make会启动独立子shell，环境变量可能和终端不一致，导致pylint行为变化：

• 在Makefile中添加环境变量导出命令：

  lint:
      env > make_env.txt
      pylint -j0 --ignore=src/_playground --extension-pkg-whitelist=gurobipy src/
      mypy --exclude src/_playground/ src/
      flake8 --exclude=src/_playground src/
  

• 在终端执行env > terminal_env.txt，对比两个文件的差异，重点关注PYTHONPATH、PATH、HOME等可能影响pylint的变量。

3. 检查pylint的文件检查范围 #

确认--ignore=src/_playground在Make环境中是否生效：
修改pylint命令添加--list-files参数，打印所有被检查的文件：

lint:
    pylint -j0 --ignore=src/_playground --extension-pkg-whitelist=gurobipy --list-files src/
    mypy --exclude src/_playground/ src/
    flake8 --exclude=src/_playground src/

将输出与终端单独执行pylint --list-files ...的结果对比，看是否有额外文件被纳入检查。

4. 查看pylint详细执行日志 #

添加-v参数启用pylint verbose模式，获取更多执行细节：

lint:
    pylint -v -j0 --ignore=src/_playground --extension-pkg-whitelist=gurobipy src/
    mypy --exclude src/_playground/ src/
    flake8 --exclude=src/_playground src/

查看输出中是否有关于依赖包（如gurobipy）的识别错误、配置文件加载异常等信息，这些可能是导致额外警告/重构建议的原因。

5. 确认工作目录一致性 #

Make默认执行时的工作目录是否与终端一致？在Makefile中添加pwd命令验证：

lint:
    pwd
    pylint -j0 --ignore=src/_playground --extension-pkg-whitelist=gurobipy src/
    mypy --exclude src/_playground/ src/
    flake8 --exclude=src/_playground src/

如果工作目录不同，可能导致pylint读取的配置文件（如.pylintrc）路径错误，或文件匹配规则失效。

临时绕过（仅用于测试流水线） #

如果需要临时让GitHub Actions流水线继续执行，可以给pylint命令添加|| true，强制让命令返回0：

lint:
    pylint -j0 --ignore=src/_playground --extension-pkg-whitelist=gurobipy src/ || true
    mypy --exclude src/_playground/ src/
    flake8 --exclude=src/_playground src/

但这只是临时方案，建议找到根本原因后修复。

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