本文介绍如何通过多进程与键盘监听机制，实现在 playsound 播放音频时按 Esc 键立即停止播放，解决该库原生不支持中断的限制，并提供可运行示例与关键注意事项。
本文介绍如何通过多进程与键盘监听机制，实现在 `playsound` 播放音频时按 esc 键立即停止播放，解决该库原生不支持中断的限制，并提供可运行示例与关键注意事项。
在 Python 中使用 playsound 库实现闹钟功能非常便捷，但其最大局限在于：它是一个阻塞式、无控制接口的音频播放器——一旦调用 playsound("alarm.mp3")，程序将挂起，直到音频自然结束，无法中途暂停或终止。这意味着仅靠 time.sleep() 或简单循环无法响应用户按键（如 Esc）。要实现“按 Esc 立即静音”，必须跳出单线程阻塞模型，采用异步控制 + 进程级强制终止的组合方案。
✅ 核心思路：用 multiprocessing 解耦播放，用 keyboard 监听热键
我们不能在主线程中直接调用 playsound（否则会卡死），而应将其放入独立子进程中运行；同时，在主线程中注册全局热键监听（Esc），触发时调用 Process.terminate() 强制结束播放进程。该方法轻量、可靠，无需额外音频解码逻辑。
⚠️ 注意：keyboard 模块需管理员权限（Windows）或 root 权限（Linux/macOS）才能捕获全局按键；开发调试建议在终端以管理员身份运行（如 Windows 的「以管理员身份运行 PowerShell」）。
? 完整可运行代码（已优化健壮性）
from playsound import playsound
import multiprocessing
import keyboard
import time
# ANSI 控制符：清屏与光标归位
CLEAR = "\033[2J"
CLEAR_AND_RETURN = "\033[H"
def play_audio(file_path: str):
"""子进程目标函数：执行阻塞式播放"""
try:
playsound(file_path)
except Exception as e:
print(f"[Warning] Audio playback error: {e}")
def start_alarm_sound(file_path: str = "alarm.mp3"):
"""启动播放进程，并绑定 Esc 终止逻辑"""
p = multiprocessing.Process(target=play_audio, args=(file_path,))
p.start()
# 注册一次性热键：按 Esc 终止进程并清理
def stop_and_cleanup():
if p.is_alive():
p.terminate()
p.join(timeout=0.1) # 确保进程资源释放
print(f"\n{CLEAR_AND_RETURN}✅ Alarm sound stopped by user.")
keyboard.add_hotkey('esc', stop_and_cleanup, suppress=True)
return p
def alarm(countdown_seconds: int):
"""倒计时闹钟主逻辑（不包含播放）"""
print(CLEAR)
time_elapsed = 0
while time_elapsed <h3>? 关键说明与最佳实践</h3>
- suppress=True 参数：阻止 Esc 键事件向其他应用透传，避免干扰终端输入；
- p.join(timeout=0.1)：确保进程终止后资源被及时回收，防止僵尸进程；
- 异常防护：对 playsound 调用包裹 try/except，避免因文件缺失或格式错误导致子进程崩溃；
- 跨平台兼容性：keyboard 在 Windows/macOS/Linux 均可用，但 Linux 需安装 sudo apt-get install python3-dev libudev-dev 并使用 pip install keyboard；
- 替代方案建议：若需更高控制精度（如暂停/继续、音量调节、流式播放），推荐迁移到 pydub + pyaudio 或 pygame.mixer，它们原生支持非阻塞播放与实时控制。
✅ 总结
playsound 适合快速原型，但缺乏交互能力；通过 multiprocessing 将播放移至子进程，再配合 keyboard 实现全局热键监听，是平衡简洁性与功能性的实用方案。只要注意权限、进程清理与异常处理，即可稳定实现“Esc 即停”的用户体验。后续如需增强功能，平滑过渡至 pygame 或 pyaudio 是更专业的演进路径。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
