Pygame导入主模块变量时出现循环导入错误求助

数据老陈

2026-8-20

解决Pygame项目中的循环导入错误

问题根源

你的代码存在循环导入链：

level.py 导入 player.py 中的 Player
player.py 导入 level.py 的所有内容以及 main.py 的所有内容
main.py 又同时导入 level.py 和 player.py

Python初始化模块时会按顺序执行导入逻辑，当遇到循环依赖时，模块还未完全初始化就被引用，直接触发ImportError。

修复步骤

1. 移除`player.py`中不必要的全局导入

当前bullets类并未用到level或main中的内容，直接删掉冗余导入，同时修正类名和方法名的拼写错误：

import pygame
from tiles import Tile

class Bullets(pygame.sprite.Sprite):
    def __init__(self, pos):
        super().__init__()
        self.image = pygame.Surface((8,8))
        self.rect = self.image.get_rect(topleft=pos)
        self.direction = 0
        self.speed = 8
        self.distcount = 0

2. 调整`level.py`的导入时机

如果Level类确实需要使用Player，将导入操作移到类内部的方法中，避免模块初始化阶段的循环依赖：

import pygame
from tiles import Tile
from map import level_map, tile_size, screen_width

class Level:
    def __init__(self, level_data, surface):
        self.display_surface = surface
        # 延迟导入，避开模块级循环
        from player import Player
        self.level_building(level_data)
        self.world_shift = 0

3. 清理`main.py`的冗余导入

删掉重复的from colors import *，保持代码整洁：

import pygame   
from colors import *  
from map import *  
from tiles import Tile
from level import Level
from player import *

pygame.init()
screen = pygame.display.set_mode((screen_width, screen_height))
sky_surface = pygame.image.load('Graphics/background.jpg')
pygame.display.set_caption('Test 1')
clock = pygame.time.Clock()
level = Level(level_map, screen)