Python中后台函数调用sys.exit()无法退出程序问题排查

我正在学习Python（使用Python 3.13.2及VScode 1.97.1），编写了一段练习程序：while循环运行计数器的同时，后台监听按键输入。按“z”键时计数器重置为0，按“q”键时程序退出。调试发现按键监听功能正常，但调用sys.exit()无法退出程序，计数器仍持续运行。

import sys
from time import sleep
import os
from pynput.keyboard import Key, Listener

def cls():    # 跨平台清除终端屏幕
  os.system('cls' if os.name=='nt' else 'clear')
    
cnt = 1
def checkKey(key):  # 按键按下时触发
  if hasattr(key, 'char'):
    if key.char == 'z':
      global cnt
      cnt = 0
    if key.char == 'q':
      sys.exit()   # 无法退出程序
  pass

# 非阻塞监听器
listener = Listener(on_press=checkKey)
listener.start()

cls()
sleep(0.5)


while True:
  print("{0}".format(cnt), end='\r', flush=True)    # 在同一行打印计数器，关闭输出缓冲
  sleep(0.5)
  cnt += 1

问题根源 #

• pynput的Listener是在独立线程中运行的，sys.exit()仅会终止当前调用它的线程（也就是监听器线程），主线程的while True无限循环完全不受影响，所以计数器会继续运行。
• 主线程未被终止，程序自然不会退出。

修复方案 #

方案1：用全局标志控制主线程循环 #

定义一个全局退出标志，在按键触发时修改标志，让主线程的循环自行终止：

import sys
from time import sleep
import os
from pynput.keyboard import Key, Listener

def cls():    # 跨平台清除终端屏幕
  os.system('cls' if os.name=='nt' else 'clear')
    
cnt = 1
exit_flag = False  # 新增退出标志

def checkKey(key):  # 按键按下时触发
  global cnt, exit_flag
  if hasattr(key, 'char'):
    if key.char == 'z':
      cnt = 0
    if key.char == 'q':
      exit_flag = True
      listener.stop()  # 先停止监听器线程
  pass

# 非阻塞监听器
listener = Listener(on_press=checkKey)
listener.start()

cls()
sleep(0.5)

# 循环条件改为检查退出标志
while not exit_flag:
  print("{0}".format(cnt), end='\r', flush=True)
  sleep(0.5)
  cnt += 1

# 等待监听器线程完全终止后再退出
listener.join()
sys.exit()

方案2：直接终止整个进程 #

如果不需要执行清理操作，用os._exit()代替sys.exit()，它会直接终止整个进程，所有线程都会停止：

# 修改checkKey函数中q键的处理逻辑
def checkKey(key):
  global cnt
  if hasattr(key, 'char'):
    if key.char == 'z':
      cnt = 0
    if key.char == 'q':
      listener.stop()
      os._exit(0)  # 直接终止整个进程
  pass

注意：os._exit()不会执行任何清理步骤（比如关闭打开的文件、执行finally代码块），适合这种简单的脚本场景。

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