sg.time.wait(3)

在 PySimpleGUI 中，sg.time.wait(3) 是一个用于暂停程序执行的函数，它会阻塞当前线程（包括 GUI 主线程）指定的时间（单位为秒）。以下是详细解析：

---

1. 功能说明

• 作用：暂停程序执行 n 秒（此处 n=3）。
• 底层实现：直接调用 Python 标准库的 time.sleep(n)。
• 特点：
  • 阻塞性：调用时会暂停整个程序（包括 GUI 事件循环），导致界面冻结。
  • 简单延迟：适用于非 GUI 场景或短时间暂停。

---

2. 与 sg.time.time() 的区别

方法	作用	是否阻塞主线程	适用场景
sg.time.wait(3)	暂停程序 3 秒	是	简单脚本、非 GUI 程序
sg.time.time()	获取当前时间戳	否	计时、非阻塞延迟控制

---

3. 典型问题：在 GUI 中使用 sg.time.wait()

❌ 错误示例（界面冻结）

import PySimpleGUI as sg

layout = [[sg.Button("点击等待"), sg.Text("状态:", key="-STATUS-")]]
window = sg.Window("错误示例", layout)

while True:
    event, values = window.read()
    if event == sg.WIN_CLOSED:
        break
    elif event == "点击等待":
        window["-STATUS-"].update("等待中...")
        sg.time.wait(3)  # 阻塞主线程，界面冻结！
        window["-STATUS-"].update("等待结束")

window.close()

问题：点击按钮后，界面会完全卡住 3 秒，无法响应其他操作。

---

4. 正确做法：非阻塞延迟

在 GUI 程序中，应使用以下方法替代 sg.time.wait()：

(1) 使用 window.read(timeout)

import PySimpleGUI as sg

layout = [[sg.Button("点击等待"), sg.Text("状态:", key="-STATUS-")]]
window = sg.Window("正确示例", layout)

wait_time = 3  # 等待 3 秒
start_time = None

while True:
    event, values = window.read(timeout=100)  # 每 100ms 检查一次事件
    if event == sg.WIN_CLOSED:
        break
    elif event == "点击等待":
        start_time = sg.time.time()
        window["-STATUS-"].update("等待中...")
    
    # 检查是否超时
    if start_time and (sg.time.time() - start_time) >= wait_time:
        window["-STATUS-"].update("等待结束")
        start_time = None

window.close()

优点：界面保持响应，不会冻结。

(2) 使用 window.timer_start()（推荐）

import PySimpleGUI as sg

layout = [[sg.Button("点击等待"), sg.Text("状态:", key="-STATUS-")]]
window = sg.Window("定时器示例", layout)

def timer_callback():
    window["-STATUS-"].update("等待结束")

while True:
    event, values = window.read()
    if event == sg.WIN_CLOSED:
        break
    elif event == "点击等待":
        window["-STATUS-"].update("等待中...")
        window.timer_start(interval=3000, key="-TIMER-", one_shot=True)  # 3 秒后触发
    elif event == "-TIMER-":
        timer_callback()

window.close()

优点：代码更简洁，逻辑清晰。

---

5. 适用场景总结

方法	适用场景	是否阻塞 GUI
sg.time.wait(3)	非 GUI 脚本、简单测试	是
window.read(timeout)	需要界面响应的延迟操作	否
window.timer_start()	精确的定时任务（如倒计时）	否

---

6. 注意事项

1. 避免在 GUI 中使用 sg.time.wait()：除非明确需要阻塞界面（如弹窗强制等待）。
2. 高精度需求：如需毫秒级延迟，使用 time.sleep(0.001) 或异步机制。
3. 替代方案：对于复杂后台任务，建议结合多线程（如 threading.Thread + write_event_value）。

---

总结

• sg.time.wait(3) 是简单的阻塞延迟，但在 GUI 程序中会导致界面冻结。
• 推荐替代方案：
  • 非阻塞延迟：window.read(timeout) + 时间戳计算。
  • 定时任务：window.timer_start()。
  • 后台任务：多线程 + write_event_value 通信。