M1 Mac/arm64 Windows11下Python线程项目信号量泄漏及GUI线程错误

问题根源 #

1. macOS UI线程限制：AppKit框架强制要求所有UI组件（如NSWindow）必须在主线程实例化和操作，原代码将GUI启动逻辑放到子线程（通过fork_unsynchronized或自定义线程），直接触发NSInternalInconsistencyException异常。
2. 主线程阻塞：原代码中音频循环在主线程执行，会阻塞GUI的事件循环，即使在Windows下也可能导致界面无响应。
3. 资源泄漏：程序因异常强制退出，导致信号量等资源未被正确释放，出现警告信息。

解决方案 #

• 所有UI相关代码必须在主线程运行
• 将音频循环逻辑放到子线程执行，避免阻塞GUI主事件循环
• 使用Python标准库threading.Thread管理音频线程，并设置为守护线程（保证程序退出时线程自动终止）

修正后的代码 #

from scamp import Session
from customtkinter import CTk, CTkLabel
from os.path import dirname, abspath
from sys import argv
import threading


class LoopingAudio:
    def __init__(self):
        super().__init__()
        self.note = 60
        self.session = Session(tempo=100)
        self.instrument = self.session.new_part("instrument", soundfont=dirname(abspath(argv[0])) + "/font.sf2")

    def looper(self):
        while True:
            self.instrument.play_note(self.note, 1, 2)


class LoopingGUI(CTk):
    def __init__(self, looper):
        super().__init__()
        self.title("looper")
        self.geometry("500x500")
        self.app_name = CTkLabel(self, text="looper")
        self.app_name.pack()


def start_looper_app():
    looper_engine = LoopingAudio()

    # 启动音频循环子线程，设置为守护线程随主程序退出
    audio_thread = threading.Thread(target=looper_engine.looper, daemon=True)
    audio_thread.start()

    # 主线程运行GUI主事件循环
    looper_gui = LoopingGUI(looper_engine)
    looper_gui.mainloop()


if __name__ == "__main__":
    start_looper_app()

关键说明 #

1. 线程角色调换：原代码将GUI放到子线程，现在改为音频逻辑在子线程，GUI在主线程，完全符合macOS的UI线程要求。
2. 守护线程设置：daemon=True确保当GUI窗口关闭时，音频线程会自动终止，避免程序残留后台进程。
3. 多进程保护：if __name__ == "__main__":是跨平台多线程/进程编程的必要保护，避免模块导入时意外执行代码。

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