如何以可移植方式判断subprocess退出码是否表示执行成功

直接用Python标准库自带的能力即可，完全不需要自己针对特殊平台写适配分支，硬编码判断process.returncode == 0确实在OpenVMS这类不遵循0为成功约定的系统上会出现误判。

• 优先使用标准库内置的校验方法
  所有Python支持的平台上，subprocess模块自带的状态校验逻辑已经做好了跨平台适配，不需要自己维护平台判断逻辑：

  • Python 3.5及以上版本可以在调用subprocess.run()时传入check=True参数，子进程执行失败时会自动抛出subprocess.CalledProcessError异常，没有抛出异常就代表执行成功。示例代码：

    import subprocess
    
    try:
        # check=True自动适配平台退出码约定，执行失败直接抛异常
        result = subprocess.run(["your_command", "arg1"], check=True, capture_output=True, text=True)
        # 走到这里即为执行成功
        print(result.stdout)
    except subprocess.CalledProcessError as e:
        # 执行失败分支
        print(f"命令执行失败，返回码：{e.returncode}")
    

  • 如果已经拿到了Popen实例或者CompletedProcess实例，直接调用实例的check_returncode()方法即可，这个方法从Python 3.9开始全平台可用，判定逻辑和check=True的内部逻辑完全一致：执行成功无返回，执行失败抛出CalledProcessError。

• 兼容Python 3.9以下版本的手动实现
  如果要适配更老的Python版本，用os模块提供的跨平台状态常量和判断宏即可，不要硬编码0作为成功判定值：

  • os.WIFEXITED(status)：判断子进程是否为正常退出（排除被信号杀死、异常终止的场景）
  • os.WEXITSTATUS(status)：从返回的状态值中提取实际的退出码
  • os.EX_OK：当前操作系统约定的代表执行成功的退出码，在Unix、Windows平台值为0，在OpenVMS等特殊平台会自动赋值为对应平台的正确值，不需要手动调整。
    示例实现：

  import os
  import subprocess
  
  proc = subprocess.Popen(["your_command", "arg1"], stdout=subprocess.PIPE, text=True)
  status = proc.wait()
  
  # 先判定是正常退出，再比对平台对应的成功退出码
  if os.WIFEXITED(status) and os.WEXITSTATUS(status) == os.EX_OK:
      print("命令执行成功")
      print(proc.stdout.read())
  else:
      print(f"命令执行异常，状态值：{status}")
  

注意：不要直接拿proc.returncode和os.EX_OK做比对，在Unix类系统中，如果进程被信号终止，returncode会是对应信号值的负数，不属于正常退出的退出码范畴，直接比对会出现误判。

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