Pygame 报错 “video system not initialized” 通常源于未正确初始化显示模块或在 pygame.init() 之后、pygame.display.set_mode() 之前调用了图形/事件相关函数，更常见的是在嵌套死循环中遗漏了事件轮询和显示更新。
pygame 报错 “video system not initialized” 通常源于未正确初始化显示模块或在 `pygame.init()` 之后、`pygame.display.set_mode()` 之前调用了图形/事件相关函数，更常见的是在嵌套死循环中遗漏了事件轮询和显示更新。
在 Pygame 开发中，“pygame.error: video system not initialized” 是一个高频但极易规避的错误。它并非表示硬件或驱动问题，而是 Pygame 的内部状态校验失败——即你在调用 pygame.display.update()、pygame.event.get() 或任何依赖显示子系统的函数时，Pygame 尚未完成视频系统初始化，或该系统已被意外关闭（如多次调用 pygame.quit()）。
? 根本原因分析
该错误在你的 Wordle 游戏代码中集中暴露于以下两个关键点：
pygame.quit() 被过早调用：
你在多个 while run: 和 while start: 循环中直接调用 pygame.quit()（例如 if event.type == pygame.QUIT: pygame.quit()），这会彻底卸载所有 Pygame 子系统（包括 video）。后续再调用 pygame.display.update() 时，因 video 系统已销毁，必然触发此错误。-
缺乏统一、顶层的主事件循环：
Pygame 要求所有图形渲染和事件处理必须发生在已初始化的上下文中，且不能脱离主循环的控制流。你当前将 pygame.event.get() 和 pygame.display.update() 分散在多层嵌套 while True / while run 中，不仅破坏了事件处理的连续性，还导致：- 外层 playgame() 函数执行到 pygame.display.update() 时，可能因内层循环已调用 pygame.quit() 而失效；
- pygame.event.get() 在无活跃显示窗口时被调用（如初始化前或 quit() 后），直接触发报错。
✅ 正确实践：单一层级主循环 + 状态机驱动
Pygame 应用应遵循“单主循环 + 状态管理”模式。所有事件获取、逻辑更新、画面绘制均在同一个顶层 while running: 循环中完成，避免任意位置调用 pygame.quit()，仅在主循环退出时调用一次。
以下是重构后的核心结构示例（适配你的 Wordle 场景）：
import pygame
# 1. 初始化（仅一次，在程序开始）
pygame.init()
screen = pygame.display.set_mode((650, 720))
pygame.display.set_caption("Wordle Game")
clock = pygame.time.Clock()
# 2. 定义游戏状态
class GameState:
MENU = 0
PLAYING = 1
GAME_OVER = 2
current_state = GameState.MENU
running = True
# 3. 主事件循环（唯一入口）
while running:
# ✅ 统一事件轮询：必须放在循环最前端！
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False # 优雅退出，不调用 pygame.quit()！
# 根据当前状态分发事件
if current_state == GameState.PLAYING:
if event.type == pygame.MOUSEBUTTONDOWN:
# 处理键盘点击逻辑（你的 a_rec, b_rec 等判断放在这里）
pass
elif event.type == pygame.KEYDOWN:
if event.key == pygame.K_RETURN:
# 切换到 GAME_OVER 状态
current_state = GameState.GAME_OVER
# 4. 渲染逻辑（根据状态）
screen.fill("White")
if current_state == GameState.MENU:
# 绘制标题、开始按钮等
pass
elif current_state == GameState.PLAYING:
# 你的 playgame() 核心逻辑 —— 但移除所有 pygame.event.get() 和 pygame.display.update()
# 只做计算、状态更新、绘制调用（如 screen.blit）
pass
elif current_state == GameState.GAME_OVER:
# 绘制胜利/失败提示、重玩提示
font = pygame.font.SysFont(None, 32)
text = font.render("Press ENTER to play again", True, "Black")
screen.blit(text, (100, 600))
# ✅ 统一刷新：每次循环结束前调用一次
pygame.display.flip() # 推荐使用 flip() 替代 update()，更清晰
clock.tick(60) # 控制帧率
# 5. 全局清理（循环结束后）
pygame.quit() # ✅ 唯一调用位置
⚠️ 关键注意事项
- 禁止在子函数中调用 pygame.quit()：它会全局销毁系统。应通过修改 running 或 current_state 标志来控制流程。
- pygame.display.set_mode() 必须在 pygame.init() 之后、任何绘图/事件调用之前执行：检查你的代码是否在 playgame() 内部或其他地方重复初始化或提前使用 display。
- 避免嵌套 while True：Pygame 不是阻塞式 GUI 框架；所有交互必须由主循环驱动。你的 while run:（字母输入）、while start:（结束提示）应改为状态切换 + 条件判断。
- 资源加载放在初始化阶段：header, keyboard, 字体等应在 pygame.init() 后、主循环前一次性加载，而非每次 playgame() 调用时重复创建。
- 调试技巧：在关键位置添加 print(pygame.display.get_init(), pygame.mixer.get_init()) 验证子系统状态。
? 总结
“Video system not initialized” 错误本质是 Pygame 生命周期管理失当。解决方案不是绕过它，而是严格遵守其设计范式：一次初始化 → 单主循环 → 状态驱动 → 一次退出。将分散的 pygame.event.get() 和 pygame.display.update() 收敛至顶层循环，用状态变量替代嵌套死循环，即可彻底根除此错误，并大幅提升代码可维护性与响应性。
