subprocess.run timeout不生效主因是目标命令异步启动或产生孤儿进程；需配合start_new_session=true（linux/macos）或create_new_process_group（windows）并手动清理进程树。
subprocess.run timeout参数不生效的常见原因
直接传timeout参数却没触发超时，多数是因为目标命令本身是异步启动后立即返回（比如某些GUI程序、后台服务或带&的shell命令），subprocess.run只等进程启动完成，不等它真正执行完。另一个典型情况是子进程创建了子子进程并退出，父进程已死但子子进程还在跑，run感知不到——这时timeout自然不会中断后续残留进程。
正确使用timeout并确保进程树被清理
必须配合shell=False（默认值）和显式进程组管理，否则timeout只能杀主进程，留下的孤儿进程继续占资源。Linux/macOS下推荐用start_new_session=True，Windows则需额外处理：
-
subprocess.run(cmd, timeout=5, start_new_session=True)—— Linux/macOS可靠方案 - Windows上
start_new_session不完全等效，建议改用creationflags=subprocess.CREATE_NEW_PROCESS_GROUP - 若命令必须走shell（如含管道、重定向），则
shell=True时start_new_session无效，得手动用psutil递归杀进程树
捕获TimeoutExpired异常并做清理
subprocess.TimeoutExpired是唯一由timeout触发的异常，但它不自动终止子进程——你得自己调proc.kill()或proc.terminate()。常见错误是只捕获异常却不处理残留进程：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
try:
result = subprocess.run(['sleep', '10'], timeout=2)
except subprocess.TimeoutExpired as e:
if e.process is not None:
e.process.kill() # 必须加这句
raise
注意：e.process可能为None（如超时发生在fork阶段），判空再操作更安全。
替代方案：用Popen手动控制更灵活
当需要精细控制（比如实时读输出+超时+强制清进程树），Popen比run更可控：
- 用
proc = subprocess.Popen(..., start_new_session=True)启动 -
proc.wait(timeout=5)等待，超时后proc.kill() - 若需捕获输出，记得设
stdout=subprocess.PIPE，且避免communicate()阻塞——它内部不支持超时 - Windows下用
proc.terminate()可能不彻底，建议搭配taskkill /T /F /PID {proc.pid}
真正麻烦的是跨平台进程树清理——start_new_session在Linux有效，Windows得靠CREATE_NEW_PROCESS_GROUP + taskkill兜底，这点容易被忽略。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
