subprocess.run() 的 timeout 参数只终止主进程，不清理子进程树；应使用 start_new_session=True（Linux/macOS）或 CREATE_NEW_PROCESS_GROUP（Windows）配合 killpg/CTRL_BREAK_EVENT，或用 psutil 显式遍历终止整个进程树。
subprocess.run() 的 timeout 参数只杀主进程，不清理子进程树
Python 的 subprocess.run() 或 subprocess.Popen.wait(timeout=...) 在超时时只会向直接子进程发送信号（如 SIGTERM），但不会递归终止其派生的整个进程树。这意味着 shell 启动的命令链（如 bash -c "sleep 10 & sleep 20"）或通过 nohup/& 后台启动的子进程大概率残留。
用 start_new_session=True 配合 os.killpg() 杀整个进程组
关键在于让子进程及其后代运行在独立会话（session）中，这样就能用进程组 ID（PGID）一次性终结整棵树。核心是：start_new_session=True（Linux/macOS）或 creationflags=subprocess.CREATE_NEW_PROCESS_GROUP（Windows）。
- Linux/macOS 下：调用
os.setsid()创建新会话，主进程成为会话首进程，其 PGID = PID；后续 fork 出的子进程默认加入该 PGID - 启动时必须加
start_new_session=True，否则os.getpgid(proc.pid)可能报错或返回父进程组 ID - 超时后用
os.killpg(os.getpgid(proc.pid), signal.SIGTERM)终止整个组，再wait()收尸
import subprocess, os, signal, timeproc = subprocess.Popen( ["bash", "-c", "sleep 5; echo 'done'"], start_newsession=True, # 必须！ stdout=subprocess.PIPE, stderr=subprocess.STDOUT ) try: stdout, = proc.communicate(timeout=2) except subprocess.TimeoutExpired: os.killpg(os.getpgid(proc.pid), signal.SIGTERM) proc.wait() # 等待进程组彻底退出
Windows 上要用 CREATE_NEW_PROCESS_GROUP + CTRL_BREAK_EVENT
Windows 没有 POSIX 进程组概念，os.killpg 不可用。必须用 subprocess.CREATE_NEW_PROCESS_GROUP 创建独立进程组，再用 os.kill() 发送 signal.CTRL_BREAK_EVENT（不能用 CTRL_C_EVENT，它可能被目标进程忽略）。
-
CTRL_BREAK_EVENT能传递给整个控制台进程组，比TerminateProcess更温和 - 必须确保子进程是控制台应用（非 GUI），否则信号无效
- 调用前需先
proc.terminate()或直接os.kill(proc.pid, signal.CTRL_BREAK_EVENT)，之后仍要proc.wait()
更健壮的做法：用 psutil 回收所有后代进程
如果无法控制启动参数（比如不能加 start_new_session），或者跨平台兼容性要求高，推荐用 psutil 手动遍历并终止子树。它不依赖会话机制，而是靠 proc.children(recursive=True) 获取全部后代。
- 安装：
pip install psutil - 注意：Windows 上需管理员权限才能终止某些系统相关子进程
- 务必按逆序终止（先叶子后父进程），避免子进程被 init 进程领养而逃逸
- 示例中
proc.children(recursive=True)返回的是实时快照，若进程瞬间启停，可能漏掉极短命子进程
import subprocess, psutil, timeproc = subprocess.Popen(["bash", "-c", "sleep 3 &"]) try: proc.communicate(timeout=1) except subprocess.TimeoutExpired: parent = psutil.Process(proc.pid) children = parent.children(recursive=True) for child in reversed(children): # 先杀孙子，再杀儿子 try: child.terminate() except (psutil.NoSuchProcess, psutil.AccessDenied): pass try: parent.terminate() parent.wait(timeout=3) except (psutil.NoSuchProcess, psutil.TimeoutExpired): pass
实际项目里，start_new_session=True 是最轻量且可靠的选择，但前提是能掌控子进程启动方式；一旦涉及遗留脚本、第三方二进制或容器化环境，psutil 的显式树遍历反而更可控——毕竟进程关系不是靠约定，而是靠实时探测。
