Windows环境下Python线程代码中Ctrl+C无法终止程序的问题排查

这个问题可不是你独有的，很多开发者在Windows环境下用Python写多线程代码时，都碰到过Ctrl+C完全无法中断程序的情况，这和你的运行环境关系不大，本质是Windows和Python线程模型、信号处理机制的差异导致的。

问题根源 #

在Mac/Linux系统里，Ctrl+C会向进程发送SIGINT信号，Python的主线程会自动捕获这个信号并触发KeyboardInterrupt异常——哪怕主线程处于等待状态，信号处理逻辑也能正常工作。

但Windows的机制完全不同：Ctrl+C触发的是控制台事件，而非POSIX标准的信号。Python的信号处理逻辑是绑定在主线程上的，当你的代码里主线程启动子线程后就直接退出（比如你的main()函数启动线程后没有任何等待逻辑就结束了），此时主线程已经终止，剩下的子线程在后台运行，但它们不会处理控制台的Ctrl+C事件，所以你按多少次都不会有反应。

看你的简化代码就能明白：main()函数启动thread0后就执行完毕，主线程直接退出，只剩下test_func所在的子线程在循环跑，Windows的控制台事件找不到能处理它的Python主线程，自然无法触发中断。

解决方案 #

核心思路就是让主线程保持活跃，并且让它能捕获KeyboardInterrupt，这里有两种常用的解决方式：

1. 让主线程等待子线程结束 #

修改main()函数，用join()让主线程等待子线程完成，这样主线程会一直处于活跃状态，能正常响应Ctrl+C：

def main():
    thread0 = threading.Thread(target=test_func)
    thread0.start()
    thread0.join()  # 主线程等待子线程，此时Ctrl+C能触发KeyboardInterrupt

2. 将子线程设为守护线程，主线程保持运行 #

如果不想让主线程完全等待子线程，可以把线程设为守护线程，然后让主线程进入一个轻量循环等待，按下Ctrl+C时主线程能捕获异常并退出，守护线程也会随之终止：

import time
import threading

def test_func():
    rounds = 0
    while True:
        print("test_func")
        print("rounds: " + str(rounds))
        time.sleep(3)
        rounds += 1

def main():
    thread0 = threading.Thread(target=test_func)
    thread0.daemon = True  # 设置为守护线程，主线程退出时自动终止
    thread0.start()
    try:
        while True:
            time.sleep(1)  # 主线程保持活跃，等待中断信号
    except KeyboardInterrupt:
        print("程序正在退出...")

if __name__ == "__main__":
    main()

额外说明 #

哪怕是嵌套线程的场景，只要保证主线程处于活跃状态并能处理信号，同样可以解决问题。核心就是不能让主线程在子线程运行前就退出，必须让主线程留在Python的事件循环中，才能响应Windows的控制台中断事件。

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