Python中在类内调用Pygame Display的fill方法触发‘display Surface quit’错误的问题咨询

这个问题我之前开发Pygame项目时也碰到过，大概率是变量作用域问题或者显示表面被意外销毁导致的，咱们一步步排查解决：

1. 优先解决全局变量的作用域问题 #

你在全局作用域定义了dis，但类的render方法可能没正确访问到这个全局变量——如果类的方法里有同名局部变量，或者模块导入时没处理好，就会导致方法里用的dis不是你初始化的那个显示表面。

更规范的做法是不要依赖全局变量，而是把显示表面作为参数传给类的实例，保存为类的属性：

# 全局初始化部分不变
import pygame

dis_width = 800
dis_height = 600
black = (0, 0, 0)

pygame.init()
dis = pygame.display.set_mode((dis_width, dis_height))
pygame.display.set_caption('Snake Game Environment')

# 修改你的环境类
class SnakeGameEnv:
    def __init__(self, display_surface):
        # 把显示表面保存为类属性
        self.display = display_surface
    
    def render(self):
        # 使用类属性调用fill，避免作用域问题
        self.display.fill(black)
        # 别忘了更新显示（如果之前没加的话）
        pygame.display.update()

# 创建实例时传入显示表面
env = SnakeGameEnv(dis)
# 调用render就不会报错了
env.render()

如果一定要用全局变量，那要在render方法里显式声明global dis，告诉Python你要使用全局的那个变量：

def render(self):
    global dis
    dis.fill(black)
    pygame.display.update()

不过这种方式不如传参的写法清晰，后期维护容易出问题，更推荐第一种做法。

2. 检查是否意外关闭了显示表面 #

如果上面的方法没用，那要排查代码中是否在调用render之前，不小心执行了pygame.display.quit()或者pygame.quit()——这两个方法会销毁显示表面，之后再调用fill就会触发这个错误。

你可以在调用render之前加个简单的检查：

print("Display initialized:", pygame.display.get_init())
env.render()

如果输出是False，说明显示已经被关闭了，找到提前调用quit的地方删掉或者调整逻辑就行。

3. 确认代码执行顺序 #

最后要确保全局的Pygame初始化代码在创建环境类实例之前执行——如果你的类实例创建在pygame.init()和set_mode()之前，那dis还没被正确初始化，自然会报错。

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