signal.alarm() 仅 Unix 系统可用，Windows 因缺乏 alarm(2) 系统调用而抛出 NotImplementedError；它仅对主线程阻塞 I/O 有效，不适用于 CPU 密集型任务或子线程；跨平台应改用 threading.Timer + Event 协作退出，或原生支持 timeout 的接口。
signal.alarm() 在非 Unix 系统上根本不可用
Windows 下直接调用 signal.alarm() 会抛出 NotImplementedError，这不是配置问题，是 Python CPython 实现层面的限制——该函数依赖底层 alarm(2) 系统调用，而 Windows 没有。所以任何基于 signal.alarm() 的超时方案在 Windows 上默认失效。
如果你的脚本需要跨平台运行，别试图“修复”它，得换思路。Unix/Linux/macOS 可用，但要注意：signal.alarm() 只对主线程生效，且会中断阻塞式系统调用（如 time.sleep()、input()、某些 socket.recv()），但对纯 Python 计算循环（比如 while True: x += 1）完全无效——信号不会被及时投递，直到下一次系统调用返回。
- 仅适用于阻塞 I/O 场景，不适用于 CPU 密集型任务
- 必须在主线程中设置，子线程调用
signal.alarm()会被忽略 - 每次只能设置一个闹钟，重复调用会覆盖前一个
- 使用后务必在 handler 中或超时后手动清除（
signal.alarm(0)），否则可能干扰后续逻辑
用 signal.signal() + 自定义 handler 实现简单超时捕获
核心是注册 SIGALRM 信号处理器，在超时发生时主动抛出异常，让主逻辑能用 try/except 拦截。注意：handler 内不能做复杂操作（如打印、日志、IO），应尽量轻量，否则可能引发重入或死锁。
import signal
import time
<p>def timeout_handler(signum, frame):
raise TimeoutError("Operation timed out")</p><h1>绑定 handler</h1><p>signal.signal(signal.SIGALRM, timeout_handler)</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><p>try:
signal.alarm(3) # 3 秒后发 SIGALRM
time.sleep(5) # 故意超时
except TimeoutError as e:
print(e)
finally:
signal.alarm(0) # 关闭闹钟，避免残留
这段代码在 Linux/macOS 上能正常输出超时提示；在 Windows 上运行会直接报错，无法进入 try 块。
替代方案：threading.Timer + 异常注入（跨平台可用）
当 signal.alarm() 不可用时，更通用的做法是把目标任务放到子线程里执行，主线程用 threading.Timer 控制超时，并通过标记位或 threading.Event 协作退出。但注意：Python 不支持从外部强制终止线程，所以不能“杀掉”正在跑的线程，只能靠任务自身配合检查退出信号。
- 适合可中断的长任务（比如循环中定期检查
event.is_set()） - 不适用于无法修改的第三方阻塞函数（如某些 C 扩展的阻塞调用）
- 需确保任务函数支持协作式取消，否则超时后线程仍在后台运行，只是主线程不再等待
示例中用 threading.Event 通知任务主动退出：
import threading
import time
<p>def risky_task(stop_event):
for i in range(10):
if stop_event.is_set():
raise KeyboardInterrupt("Task cancelled by timeout")
time.sleep(1)
return "done"</p><p>def run_with_timeout(func, args=(), kwargs=None, timeout=5):
if kwargs is None:
kwargs = {}
stop_event = threading.Event()
result = [None]
exc = [None]</p><pre class="brush:php;toolbar:false;">def wrapper():
try:
result[0] = func(*args, **kwargs)
except Exception as e:
exc[0] = e
t = threading.Thread(target=wrapper)
t.start()
timer = threading.Timer(timeout, stop_event.set)
timer.start()
t.join(timeout)
timer.cancel()
if t.is_alive():
raise TimeoutError(f"Task did not complete within {timeout}s")
if exc[0]:
raise exc[0]
return result[0]使用
try: print(run_with_timeout(risky_task, (stop_event,), timeout=3)) except TimeoutError as e: print(e)
真正难处理的是不可中断的 C 扩展阻塞调用
比如用 requests.get() 访问一个永远不响应的地址，或调用某个封装了 C 库的函数（如某些数据库驱动的 execute()），它们可能绕过 Python 的信号机制，在内核态长时间阻塞。此时 signal.alarm() 失效，threading.Timer 也只等得到线程结束，无法中止底层系统调用。
这类场景必须依赖原生支持超时的接口：比如 requests.get(url, timeout=5)、socket.settimeout(5)、subprocess.run(..., timeout=5)。不要幻想用 signal 或线程包装去“强行打断”，那只会留下僵尸线程或资源泄漏。
如果第三方库没提供 timeout 参数，又必须用，唯一较稳妥的退路是起独立进程（multiprocessing.Process），主进程用 proc.join(timeout) 等待，超时后调用 proc.terminate()。但要注意进程间状态不共享、启动开销大、Windows 上 fork 行为不同等问题。
