使用subprocess.run执行Pylint返回退出状态码28的问题

我之前在Windows环境折腾Python工具的时候也碰到过类似的“无文档说明退出码”问题，针对你遇到的情况，给你几个实用的排查和解决方向：

• 检查subprocess的调用参数与路径
  Windows下的subprocess和Linux/macOS有不少差异，首先确认你是否正确指定了Pylint的调用路径，或者是否开启了shell=True参数。
  比如如果你的代码是：

  subprocess.run(["pylint", "your_script.py"])
  

  可以改成两种方式试试：

  1. 加上shell=True，让系统通过shell来解析命令：

     subprocess.run(["pylint", "your_script.py"], shell=True)
     

  2. 使用Pylint可执行文件的绝对路径（比如你的Python3.5安装在C:\Python35）：

     subprocess.run(["C:/Python35/Scripts/pylint.exe", "your_script.py"])
     

• 捕获Pylint的完整输出，排查隐藏错误
  退出码28可能是Pylint在Windows下抛出的非标准错误码，直接看返回码找不到线索，不如捕获它的所有输出（包括stderr）：

  import subprocess
  
  try:
      output = subprocess.check_output(
          ["pylint", "your_script.py"],
          stderr=subprocess.STDOUT,
          shell=True,
          universal_newlines=True
      )
      print(output)
  except subprocess.CalledProcessError as e:
      print(f"退出码: {e.returncode}")
      print(f"完整输出:\n{e.output}")
  

  这样能看到Pylint实际运行时的报错信息，比如依赖缺失、路径权限或者文件解析问题，这些信息可能比模糊的退出码更有用。

• 同步subprocess的环境变量
  有时候subprocess默认继承的环境变量和你手动打开控制台时的环境变量不一致，导致Pylint无法正常加载依赖。你可以手动传递当前控制台的环境变量：

  import os
  import subprocess
  
  # 复制当前环境变量
  current_env = os.environ.copy()
  result = subprocess.run(
      ["pylint", "your_script.py"],
      env=current_env,
      shell=True
  )
  

• 更新或降级Pylint到兼容Python3.5的版本
  Python3.5已经停止维护，对应的Pylint版本也比较旧，可能存在Windows下的兼容性bug。你可以尝试安装最后支持Python3.5的Pylint版本：

  pip install pylint==2.11.1
  

  这个版本是官方最后支持Python3.5的稳定版，可能修复了旧版本中存在的退出码异常问题。

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