VSCode中Jupyter Notebook中断执行超时，如何避免重启内核？

问题原因 #

你遇到的超时问题，本质是因为time.sleep()这类阻塞式系统调用会让Python进程进入无法响应中断信号的状态。VSCode发送的中断请求需要Python内核处理信号，但阻塞调用期间GIL不会释放，信号处理逻辑无法执行，最终导致中断超时，只能选择重启内核。

解决方案 #

1. 修改代码为可中断的逻辑（适合自定义代码） #

把长时长的阻塞操作拆分为小段执行，同时检查中断信号：

import time
import signal

interrupted = False

def handle_interrupt(_, __):
    global interrupted
    interrupted = True

# 注册SIGINT信号处理器（对应Ctrl+C/停止按钮的中断）
signal.signal(signal.SIGINT, handle_interrupt)

# 拆分20秒等待为20次1秒等待，每次检查中断状态
for _ in range(20):
    if interrupted:
        print("执行已中断")
        break
    time.sleep(1)

这种方式让进程每隔1秒就有机会处理中断信号，避免完全阻塞。如果是异步场景，也可以用asyncio.sleep()，它本身就是可中断的：

import asyncio

async def main():
    await asyncio.sleep(20)

# 在Jupyter中运行异步代码
await main()

2. 手动发送中断信号（适合无法修改的第三方代码） #

如果代码无法修改，可通过Windows的命令行发送中断信号：

• 打开VSCode终端（Ctrl+），执行tasklist | findstr python`找到对应Jupyter内核的进程ID（PID）
• 执行taskkill /PID <你的进程PID> /SIGINT，这个命令会给进程发送类似Ctrl+C的中断信号，内核会响应并停止当前单元格执行，同时保留已有的变量。

3. 调大VSCode的中断超时阈值 #

打开VSCode设置（Ctrl+,），搜索jupyter.interruptTimeout，将默认的3000毫秒（3秒）调整为更大的值（比如10000毫秒=10秒）。这个方法对部分非极端阻塞的代码有效，但对time.sleep()这类完全阻塞的操作作用有限。

注意事项 #

对于底层系统级的阻塞操作（如某些C扩展的计算、原生sleep），Python无法在阻塞期间处理信号，此时只能通过修改代码逻辑或手动发送信号的方式解决，无法依赖VSCode的停止按钮直接中断。

内容的提问来源于stack exchange，提问作者zest16