Pygame中二维列表渲染BackgroundCube背景方块无显示问题

我来帮你排查下问题，你的代码框架其实没问题，只是几个关键的小疏漏导致窗口一直空白：

1. 最核心的问题：没有更新屏幕显示 #

Pygame的绘制操作都是在后台缓冲区完成的，不会自动同步到窗口上。你需要在绘制完所有元素后手动调用屏幕更新函数，否则用户根本看不到任何内容。

在redrawGameWindow函数末尾添加一行：

pygame.display.update()

或者用pygame.display.flip()（单屏幕场景下两者效果一致）。这一步是让缓冲区的内容刷新到可视窗口的关键。

2. 数组索引逻辑混乱 #

你的background_cube_list初始化时，外层列表对应y方向的行数（(HEIGHT-20)/20 = 20），内层列表对应x方向的列数（WIDTH/20 = 20），也就是数组结构是[y索引][x索引]。但你在赋值和绘制时搞反了索引对应关系：

• 赋值时用background_cube_list[cube][cube1]，把x方向的循环变量放在了y索引的位置
• 绘制时用background_cube_list[x][y]，同样颠倒了x和y的索引

这次因为行列数刚好都是20没报错，但逻辑完全错误，后续修改窗口尺寸一定会出问题。调整如下：

修正赋值逻辑（移到循环外，避免重复创建实例） #

for y_idx in range(int((HEIGHT - 20) / 20)):
    for x_idx in range(int(WIDTH / 20)):
        background_cube_list[y_idx][x_idx] = BackgroundCube(x_idx * 20, y_idx * 20, 20, 20, (144, 144, 144))

修正绘制逻辑 #

def redrawGameWindow():
    screen.fill((255,255,255))  # 填充背景，避免画面残留
    for y_idx in range(int((HEIGHT-20)/20)):
        for x_idx in range(int(WIDTH/20)):
            cube2 = background_cube_list[y_idx][x_idx]
            cube2.draw(screen)
    pygame.display.update()  # 新增屏幕更新

3. 补全必要的初始化步骤 #

你的代码缺少两个关键的Pygame初始化操作：

• 必须调用pygame.init()初始化所有Pygame模块
• 必须初始化clock变量，否则clock.tick(30)会报错

在代码开头添加：

import pygame
pygame.init()
clock = pygame.time.Clock()

4. 避免不必要的资源浪费 #

你之前在while run循环里每次都重新创建所有BackgroundCube实例，这完全没必要，会白白消耗系统资源。把数组初始化代码移到循环外面，只执行一次即可。

完整修正后的代码 #

import pygame
pygame.init()

WIDTH = 400
HEIGHT = 420
screen = pygame.display.set_mode((WIDTH, HEIGHT))
clock = pygame.time.Clock()

class BackgroundCube:
    def __init__(self, x, y, width, height, color):
        self.x = x
        self.y = y
        self.width = width
        self.height = height
        self.color = color
    def draw(self, screen):
        pygame.draw.rect(screen, self.color, (self.x, self.y, self.width, self.height), 2)

def redrawGameWindow():
    screen.fill((255, 255, 255))
    for y_idx in range(int((HEIGHT-20)/20)):
        for x_idx in range(int(WIDTH/20)):
            cube2 = background_cube_list[y_idx][x_idx]
            cube2.draw(screen)
    pygame.display.update()

run = True
# 初始化背景方块列表（仅执行一次）
background_cube_list = [[0 for x in range(int(WIDTH/20))] for y in range(int((HEIGHT-20)/20))]
for y_idx in range(int((HEIGHT - 20) / 20)):
    for x_idx in range(int(WIDTH / 20)):
        background_cube_list[y_idx][x_idx] = BackgroundCube(x_idx * 20, y_idx * 20, 20, 20, (144, 144, 144))

while run:
    # 添加事件处理，支持关闭窗口
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            run = False

    clock.tick(30)
    redrawGameWindow()

pygame.quit()

我还额外添加了窗口关闭的事件处理逻辑，这样你可以正常退出程序，不会出现卡住的情况。

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