Pygame开发报错求助：UnboundLocalError变量引用问题

刚接触Pygame踩这种变量作用域的坑太正常了，我来帮你理清楚问题出在哪，以及怎么解决：

错误原因 #

这个报错本质是变量作用域的误解：
如果你在函数外面（全局作用域）定义了bullets列表，但在函数内部（比如处理按键的主循环里）直接去修改它（比如bullets.append(...)），Python会默认把bullets当成一个局部变量。但你在给这个局部变量赋值（或者修改它）之前，Python找不到它的定义，就会抛出这个"引用前未赋值"的错误。

具体解决方案 #

我结合你的代码片段，整理了修复后的完整示例，关键改动我标出来了：

import pygame
import time
import random
import sys
import os

pygame.init()
display_width = 800
display_height = 600

# 补全你没写完的颜色定义
black = (0, 0, 0)
white = (255, 255, 255)
red = (200, 0, 0)
green = (0, 200, 0)

# 1. 全局初始化子弹列表，这一步必须有！
bullets = []

# 假设你的角色xeon的基础属性
xeon_width = 50
xeon_height = 50
xeon_x = display_width // 2 - xeon_width // 2
xeon_y = display_height - xeon_height - 10

def game_loop():
    # 2. 声明要使用的全局变量，告诉Python不要把bullets当成局部变量
    global xeon_x, xeon_y, bullets
    game_exit = False
    # 初始化显示窗口（最好放外面，这里为了完整性写进来）
    game_display = pygame.display.set_mode((display_width, display_height))
    pygame.display.set_caption("Xeon's Bullet Test")

    while not game_exit:
        for event in pygame.event.get():
            if event.type == pygame.QUIT:
                pygame.quit()
                sys.exit()

            # 处理向下箭头按键发射子弹
            if event.type == pygame.KEYDOWN:
                if event.key == pygame.K_DOWN:
                    # 创建子弹矩形：从角色中心位置发射，大小10x5
                    bullet = pygame.Rect(
                        xeon_x + xeon_width//2 - 5, 
                        xeon_y, 
                        10, 
                        5
                    )
                    bullets.append(bullet)

        # 3. 移动子弹（水平向右，你可以改成向左调整数值）
        # 用bullets[:]切片遍历，避免遍历中修改列表导致报错
        for bullet in bullets[:]:
            bullet.x += 5  # 水平移动速度
            # 子弹超出屏幕就移除
            if bullet.x > display_width:
                bullets.remove(bullet)

        # 绘制所有元素
        game_display.fill(white)
        # 绘制角色xeon
        pygame.draw.rect(game_display, red, (xeon_x, xeon_y, xeon_width, xeon_height))
        # 绘制所有子弹
        for bullet in bullets:
            pygame.draw.rect(game_display, black, bullet)

        pygame.display.update()
        pygame.time.Clock().tick(60)

game_loop()

额外注意点 #

• 如果你不想用全局变量，也可以把bullets作为参数传递给函数，但对于Pygame主循环这种场景，全局变量是更简洁的选择。
• 遍历子弹列表做移除操作时，一定要用bullets[:]（创建列表副本）来遍历，不然直接遍历原列表并修改会导致迭代出错。

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