Python Arcade开发的井字棋游戏启动白屏问题求助

问题原因 #

启动时的白屏，本质是窗口显示前主线程被耗时操作（比如加载资源、初始化复杂逻辑）卡住了，导致Arcade没法及时渲染初始界面。你用的time.sleep()完全没用，反而会让主线程卡得更久，白屏时间更长。

具体解决方法 #

1. 按Arcade规范把初始化逻辑移到setup()方法 #

Arcade的标准开发流程是：

• __init__只做窗口基础配置（尺寸、标题这些），别塞耗时操作
• 所有加载资源、初始化游戏状态的活儿，全放到setup()里——这个方法会在窗口创建好之后执行，不会阻塞初始渲染

示例代码结构：

import arcade

class TicTacToeGame(arcade.Window):
    def __init__(self):
        # 仅初始化窗口基础参数，别加耗时操作
        super().__init__(width=600, height=600, title="井字棋")
        # 先声明空属性，后续在setup里赋值
        self.board_sprites = None
        self.game_board = None

    def setup(self):
        # 在这里加载所有Sprite、初始化棋盘
        self.board_sprites = arcade.SpriteList()
        # 加载棋子、棋盘背景图等操作
        self.game_board = [[None for _ in range(3)] for _ in range(3)]
        # 提前设置背景色，避免白屏
        arcade.set_background_color(arcade.color.LIGHT_GRAY)

    def on_draw(self):
        arcade.start_render()
        # 绘制逻辑：确保资源加载完成后再绘制
        if self.board_sprites:
            self.board_sprites.draw()
        # 绘制棋盘线条等其他元素

if __name__ == "__main__":
    game_window = TicTacToeGame()
    game_window.setup()
    arcade.run()

2. 提前设置背景色 #

不管资源加载没加载完，先给窗口设置个背景色，这样启动时就会显示你设置的颜色，替代白屏：

# 可以在__init__或setup里加这句
arcade.set_background_color(arcade.color.LIGHT_GRAY)

3. 异步加载大资源（如果有） #

要是你加载的资源比较大，用Arcade的异步加载方法，别阻塞主线程：

async def load_game_textures(self):
    self.x_texture = await arcade.load_texture_async("x_icon.png")
    self.o_texture = await arcade.load_texture_async("o_icon.png")

# 在setup里调用异步加载
async def setup(self):
    await self.load_game_textures()
    # 其他初始化操作

额外检查点 #

• 看看你原来的代码里，是不是在__init__里写了循环计算、大量文件读取这类耗时操作，全部移去setup()
• 确认Sprite的文件路径是对的，别因为找不到资源导致隐性阻塞

内容的提问来源于stack exchange，提问作者Вадим Ткаченко