使用readline()读取文件文本并显示到Pygame窗口的问题排查

问题原因分析 #

1. readline()循环窗口无显示

• 缺少Pygame事件处理：窗口需要持续处理事件（比如关闭操作），否则会假死，无法完成渲染。
• 未刷新屏幕：绘制文本后必须调用pygame.display.flip()或pygame.display.update()，否则内容不会显示到窗口。
• 文本与背景色重合：如果文本颜色和窗口背景色一致，即使绘制了也看不到内容。

2. 逐行遍历仅显示最后一行

• 重复填充背景：每次循环执行screen.fill(...)会清除之前绘制的所有内容，最后只保留最后一行。
• 坐标重复：所有文本都绘制在同一个(x,y)位置，重叠后仅能看到最后一行。

解决方案代码 #

以下是完整的实现示例，包含文件读取、分行绘制、事件处理的正确逻辑：

import pygame

# 初始化Pygame
pygame.init()

# 设置窗口参数
WIDTH, HEIGHT = 400, 300
screen = pygame.display.set_mode((WIDTH, HEIGHT))
pygame.display.set_caption("多行文本显示")

# 颜色定义
WHITE = (255, 255, 255)
BLACK = (0, 0, 0)

# 设置字体（可替换为系统字体名称或自定义字体路径）
font = pygame.font.SysFont(None, 36)

# 读取TXT文件内容，处理换行符与空行
lines = []
with open("test.txt", "r", encoding="utf-8") as f:
    for line in f:
        stripped_line = line.strip()
        if stripped_line:  # 跳过空行
            lines.append(stripped_line)

# 主循环
running = True
while running:
    # 处理窗口事件
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

    # 填充背景（仅在循环开头执行一次，避免覆盖已绘制内容）
    screen.fill(WHITE)

    # 逐行绘制文本，设置垂直偏移实现分行
    y_offset = 50  # 初始垂直位置
    line_spacing = 40  # 行间距
    for idx, line_text in enumerate(lines):
        text_surface = font.render(line_text, True, BLACK)
        # 水平居中，垂直逐行下移
        x_pos = (WIDTH - text_surface.get_width()) // 2
        y_pos = y_offset + idx * line_spacing
        screen.blit(text_surface, (x_pos, y_pos))

    # 刷新屏幕，显示所有绘制内容
    pygame.display.flip()

# 退出Pygame
pygame.quit()

关键要点说明 #

• 文件读取：用with语句安全读取文件，去除每行的换行符和空行，避免绘制无效内容。
• 坐标控制：通过y_offset + idx * line_spacing实现每行文本的垂直偏移，确保分行显示不重叠。
• 事件循环：必须保留pygame.event.get()处理退出事件，保证窗口正常响应操作。
• 屏幕刷新：所有绘制完成后统一调用pygame.display.flip()，确保所有文本一次性显示。

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