pytest.main()返回ExitCode枚举而非整数，正确做法是导入ExitCode并比对枚举值；shell中须立即用$?获取退出码，避免子shell或管道导致失效；兼容旧版可用.exit_code.value。
pytest.main() 返回值就是退出码，别用 os.system
直接调用 pytest.main() 会返回一个 ExitCode 枚举实例，不是字符串也不是整数——这是最常被忽略的前提。很多人用 os.system("pytest")，结果只能拿到 0/1 两个值，丢失了 2（用户中断）、4（命令错误）、5（没找到用例）等关键区分。
正确做法是显式导入并处理枚举：
from pytest import ExitCode
import pytest
<p>exit_code = pytest.main(["test_example.py"])
if exit_code == ExitCode.OK:
print("全部通过")
elif exit_code == ExitCode.TESTS_FAILED:
print("有失败用例")
elif exit_code == ExitCode.NO_TESTS_COLLECTED:
print("警告：没收集到任何测试")
注意：pytest.main() 不抛异常，只返回枚举；而 os.system 或 subprocess.call 返回的是原始整数，需手动映射，容易出错。
在 shell 脚本里判断 pytest 退出码必须用 $?
如果你封装的是 shell 脚本（比如 run_tests.sh），pytest 命令执行完后，**立刻**用 $? 拿退出码，不能缓存、不能跨行赋值、不能进管道——这些都会重置它。
立即学习“Python免费学习笔记（深入）”；
- ✅ 正确：
pytest test_api.py; echo "退出码: $?" - ❌ 错误：
code=$(pytest test_api.py); echo $code（子 shell 中的 $? 不会透出） - ❌ 错误：
pytest test_api.py | tee log.txt; echo $?（管道中 $? 是 tee 的退出码）
常见陷阱：CI 流水线里写 if [ $(pytest ...) ]; then —— 这实际在检测命令是否“有输出”，完全不是退出码逻辑。
ExitCode 枚举值和对应整数必须一一对应记牢
六种退出码含义固定，但不同版本 pytest 的枚举名略有差异（如 TESTS_FAILED 在旧版叫 FAILED）。建议始终用 .value 属性做兼容性兜底：
exit_code = pytest.main(["-x", "test_slow.py"])
print(f"原始枚举: {exit_code}, 整数值: {exit_code.value}")
<h1>安全比对（兼容老版本）</h1><p>if exit_code.value == 1:
handle_failure()
elif exit_code.value == 5:
handle_no_tests()
关键点：
-
ExitCode.OK.value == 0，不是所有成功路径都走这里——比如 pytest 启动失败但没报错，也可能返回 0 -
ExitCode.NO_TESTS_COLLECTED（5）常被误判为“环境配置问题”，其实只是文件名/路径/标记不符合test_*.py或*_test.py规则 -
ExitCode.INTERNAL_ERROR（3）往往源于插件冲突或 fixture 循环依赖，此时pytest -v --tb=short才能看到真实 traceback
自定义退出逻辑时，避免覆盖 sys.exit()
有人想在测试结束后统一做报告归档或发通知，于是写：
if __name__ == "__main__":
code = pytest.main()
if code != ExitCode.OK:
send_alert()
sys.exit(code) # ← 这里危险
问题在于：如果 send_alert() 抛异常，sys.exit() 根本不会执行，进程以异常退出码 1 结束，掩盖了原本的 ExitCode.TESTS_FAILED（1）或 ExitCode.NO_TESTS_COLLECTED（5）。
更稳妥的方式是：
- 把清理/通知逻辑放在
try/finally块里 - 确保
sys.exit()是最后一行，且参数是明确的整数（sys.exit(int(code.value))） - 绝不让非 pytest 相关逻辑影响退出码语义
真正难处理的，从来不是“怎么取退出码”，而是当 pytest.main() 卡死、超时、或被信号终止时，你根本拿不到返回值——这种情况下，退出码不可信，得靠超时机制和外部进程监控兜底。
