subprocess.run()的timeout参数仅终止主进程，不清理其子进程树；需分平台处理：Linux/macOS用start_new_session=True配合os.killpg()，Windows用CREATE_NEW_PROCESS_GROUP配合taskkill /t /f。
subprocess.run() 的 timeout 参数只杀主进程，不清理子进程
Python 的 subprocess.run() 或 subprocess.Popen.wait() 设置 timeout 后，超时触发的 subprocess.TimeoutExpired 异常只会调用主进程的 terminate()（Windows）或 kill()（Linux），但**不会自动递归杀死其派生的子进程树**。尤其在 Windows 上，子进程常变成孤儿并持续运行；Linux 下若主进程 fork 出后台服务（如 ssh -f、python -m http.server），也可能残留。
跨平台安全终止进程树：用 os.killpg()（Linux/macOS）+ win32api（Windows）
标准库没有跨平台的“杀进程树”接口，需分平台处理。核心思路是：启动时让子进程加入新进程组（Linux/macOS）或启用作业对象（Windows），再统一销毁整个组/作业。
- Linux/macOS：用
start_new_session=True启动，使子进程成为新会话首进程，之后用os.killpg()杀整个进程组 - Windows：用
creationflags=subprocess.CREATE_NEW_PROCESS_GROUP，再通过win32job或taskkill /t /f /pid实现树杀 —— 但win32job需额外装pywin32，更轻量做法是调用taskkill - 注意：Windows 上
shell=True会绕过CREATE_NEW_PROCESS_GROUP，应避免或手动构造 cmd.exe 调用
示例（Linux/macOS 安全版）：
import subprocess, os, signalproc = subprocess.Popen(["sh", "-c", "sleep 10; echo done"], start_new_session=True) try: proc.wait(timeout=2) except subprocess.TimeoutExpired: os.killpg(proc.pid, signal.SIGTERM) # 杀整个进程组 proc.wait()
Windows 下用 taskkill /t /f 替代原生 API 更可靠
Windows 原生 API（如 win32job 或 TerminateJobObject）配置复杂且容易因权限或 UAC 失败。taskkill /t /f /pid 是微软官方支持的树杀命令，兼容性好、无需额外依赖。
-
/t表示包含子进程树，/f强制终止，/pid指定主进程 ID - 必须确保
proc.pid是顶层控制台进程（即没被 cmd.exe 包裹），否则taskkill只杀 cmd 而非真实子进程 —— 所以仍要加creationflags=subprocess.CREATE_NEW_PROCESS_GROUP - 不要用
shell=True，改用["cmd.exe", "/c", "..."]显式调用，并对cmd.exe启用CREATE_NEW_PROCESS_GROUP
Windows 示例：
import subprocess import sysproc = subprocess.Popen( ["ping", "-n", "10", "127.0.0.1"], creationflags=subprocess.CREATE_NEW_PROCESS_GROUP ) try: proc.wait(timeout=2) except subprocess.TimeoutExpired: subprocess.run(["taskkill", "/t", "/f", "/pid", str(proc.pid)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) proc.wait()
别忽略 Windows 上的 CREATE_NO_WINDOW 和权限问题
即使加了 CREATE_NEW_PROCESS_GROUP，Windows 进程仍可能因窗口行为或权限卡住：
- 如果目标程序弹 GUI 窗口（如
notepad.exe），默认会继承父窗口句柄，导致taskkill无法强制结束 —— 加creationflags=subprocess.CREATE_NO_WINDOW可避免 - 某些系统进程（如需要管理员权限启动的服务）可能拒绝被普通用户
taskkill—— 此时需提前以管理员身份运行 Python 脚本，或改用更底层的psutil库遍历子进程手动 kill -
psutil是最省心的跨平台方案，但属于第三方依赖；若不能引入，上述taskkill+start_new_session组合已覆盖 95% 场景
真正麻烦的是那些不守 POSIX 规则、不响应 SIGTERM、或主动 daemonize 的程序 —— 它们根本不在进程组里，只能靠 psutil.Process(proc.pid).children(recursive=True) 手动找并逐个 kill。
