超时控制不能只靠time.sleep()，因其仅暂停线程而不中断计算或阻塞IO；需用signal.alarm()（仅Unix）、线程+Event/ThreadPoolExecutor（跨平台）或multiprocessing（强制终止不可中断任务）。
超时控制在Python里为什么不能只靠 time.sleep()？
因为 time.sleep() 只是暂停当前线程，它不中止正在运行的计算或阻塞IO。真正需要的是“到时间就强制停掉函数执行”，而Python默认不提供这种中断能力——尤其是对纯CPU密集型任务，信号无法中断正在执行的字节码；对阻塞IO（如 requests.get()），底层系统调用可能忽略信号。
用 signal.alarm() 实现超时：只适用于Unix/Linux/macOS
signal.alarm() 是最轻量的超时方案，但仅限类Unix系统，Windows直接抛出 NotImplementedError。它依赖 SIGALRM 信号，在信号处理器中抛出异常来中断主流程。
常见错误现象：AlarmClockError 没被正确捕获、超时后函数仍继续执行（因信号未触发或被屏蔽）、多线程中调用 signal.alarm() 失效（信号只对主线程有效）。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 必须在主线程中使用，且不能在子线程里调用
signal.alarm() - 超时函数体内不能有长时间阻塞且不可中断的操作（如
time.sleep(10)会被中断，但numpy.dot()这类C扩展通常不会） - 记得在函数退出前调用
signal.alarm(0)关闭定时器，否则会影响后续逻辑 - 示例：
import signal
<p>def timeout_handler(signum, frame):
raise TimeoutError("Function call timed out")</p><p>def run_with_timeout(func, args=(), kwargs={}, timeout=5):
signal.signal(signal.SIGALRM, timeout_handler)
signal.alarm(timeout)
try:
result = func(*args, **kwargs)
signal.alarm(0) # 取消闹钟
return result
except TimeoutError:
raise
finally:
signal.alarm(0) # 确保清理
用线程 + threading.Event 或 queue.Queue 实现跨平台超时
这是兼容Windows和Linux的通用做法，核心思路是：把目标函数放到子线程执行，主线程等待结果，超时则放弃线程（注意：Python无法强制杀死线程，只能设标志位并依赖函数内部配合检查）。
关键限制：你无法真正“终止”一个已卡死的线程，所以函数本身需支持协作式退出（比如定期检查 event.is_set()），否则超时只是主线程放弃等待，后台线程仍在跑。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 不要用
threading.Thread.terminate()—— 它根本不存在，Python没提供该接口 - 推荐用
concurrent.futures.ThreadPoolExecutor配合future.result(timeout=...)，它封装了等待逻辑，更安全 - 若函数不含可中断点（如死循环、C扩展阻塞），线程超时方案也无效，此时只能换进程（
multiprocessing） - 示例（简洁版）：
from concurrent.futures import ThreadPoolExecutor, TimeoutError as FutureTimeoutError
import time
<p>def run_with_timeout(func, args=(), kwargs={}, timeout=5):
with ThreadPoolExecutor(max_workers=1) as executor:
future = executor.submit(func, *args, **kwargs)
try:
return future.result(timeout=timeout)
except FutureTimeoutError:
raise TimeoutError(f"Function did not complete within {timeout}s")
什么时候必须用 multiprocessing 而不是线程？
当目标函数是纯CPU密集型且完全不可中断（比如陷入C库死循环、无检查点的数值计算），线程方案失效，因为GIL虽被释放，但子线程仍无法被外部中止。此时唯一可靠方式是启动独立进程，用 process.terminate() 强制结束。
代价明显：进程开销大、无法共享内存、参数/返回值需序列化（pickle 限制）。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 确保函数及其参数可被
pickle序列化，否则Process.start()会静默失败 - 超时判断后要显式调用
process.join(timeout)再process.terminate()，否则可能残留僵尸进程 - Windows下需将进程启动代码包裹在
if __name__ == "__main__":中，否则反复fork
真正难处理的，从来不是怎么写超时逻辑，而是函数本身是否设计为可中断——如果它从不检查退出信号、不响应中断、不释放GIL、也不做任何I/O，那所有超时机制都只是“假装结束了”。
