本文详解如何使用 python 的 `subprocess` 模块可靠运行 newman 命令行工具，解决“file not found”错误及 npm 无法识别 newman 的常见问题，并提供可直接复用的安全调用方案。
在自动化 API 测试流程中，常需通过 Python 脚本触发 Newman（Postman 官方 CLI 工具）执行集合（Collection）并生成报告。但直接使用 subprocess.Popen() 调用 newman 命令时，容易遇到 FileNotFoundError: [WinError 2] 系统找不到指定的文件 —— 这并非因为 Newman 未安装，而是 Python 默认无法在 PATH 环境中解析命令别名（如 newman），尤其在 Windows 下，Shell 解析器（如 cmd.exe）才负责将 newman 映射到其实际可执行路径（例如 node_modules\.bin\newman.cmd）。
✅ 正确做法是启用 shell=True 参数，让系统通过默认 Shell（Windows 下为 cmd.exe，Linux/macOS 下为 /bin/sh）解析并执行命令，从而支持环境变量路径查找与批处理脚本调用：
import subprocess
collection_path = r"C:\tests\api-collection.json"
export_path = r"C:\reports\exported-collection.json"
try:
process = subprocess.Popen(
["newman", "run", collection_path, "--export-collection", export_path],
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
shell=True, # ? 关键：启用 shell 解析，支持 PATH 查找和 .cmd/.bat 调用
text=True, # ? 推荐：自动解码字节流为字符串（Python 3.7+）
encoding="utf-8"
)
print(f"Newman 启动成功，PID: {process.pid}")
stdout, stderr = process.communicate() # 等待完成并获取输出
print(f"返回码: {process.returncode}")
if stdout:
print("标准输出:\n", stdout)
if stderr:
print("错误输出:\n", stderr)
except FileNotFoundError:
print("❌ 错误：newman 未找到。请确认已全局安装：npm install -g newman")
except Exception as e:
print(f"❌ 执行异常: {e}")
⚠️ 注意事项：
- 不要混用 npm.cmd newman ...：npm.cmd 是包管理器入口，不接受 newman 作为子命令；正确方式是 npm exec newman -- run ...（需 Node.js ≥16.14）或直接调用 newman（推荐）；
- 路径安全：Windows 中建议使用原始字符串（r"..."）或双反斜杠避免转义错误；Linux/macOS 使用正斜杠即可；
- 权限与环境：确保运行脚本的用户环境已正确配置 PATH（含 Node.js 和 newman 的安装路径），可通过 subprocess.run(["where", "newman"], shell=True)（Windows）或 ["which", "newman"]（macOS/Linux）验证；
-
生产增强建议：
- 使用 subprocess.run(..., timeout=300) 避免无限挂起；
- 添加 --reporters cli,junit,html --reporter-html-export ./reports/report.html 生成多格式报告；
- 通过 env=os.environ.copy() 显式传递环境变量，避免 CI/CD 中环境隔离问题。
总结：shell=True 是打通 Python 与 Shell 命令生态的关键开关，它使 subprocess 能真正“像你在终端里敲命令一样”工作。只要 Newman 已通过 npm install -g newman 全局安装，此方案即可跨平台稳定运行——无需硬编码绝对路径，也无需绕行 npm 调度。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
