运行Pygame项目出现循环导入错误，该如何排查修复？

问题根源 #

你遇到的循环导入是因为项目依赖形成了闭环：主文件autopilot.py导入了car模块，而car.py、bullet.py、debris.py又在模块顶层反过来导入autopilot.py里的screen、bullet_group等变量，Python加载模块时陷入循环无法完成初始化。

修复步骤 #

步骤1：新增全局配置文件config.py #

把所有模块需要共享的常量、全局对象都放到这个独立文件里，避免跨模块交叉导入主文件：

import pygame

# 屏幕参数
WIDTH = 1000
HEIGHT = 400

# 初始化全局屏幕对象
pygame.init()
screen = pygame.display.set_mode((WIDTH, HEIGHT))
pygame.display.set_caption("AutoPilot")

# 全局精灵组
bullet_group = pygame.sprite.Group()
debris_group = pygame.sprite.Group()

步骤2：修改debris.py #

把导入autopilot的逻辑改成导入config，其余代码保持不变：

import pygame
from config import HEIGHT, screen

#debris class
class Debris(pygame.sprite.Sprite):
    def __init__(self, scale, speed):
        pygame.sprite.Sprite.__init__(self)

        self.x = 400
        self.y = HEIGHT / 2 - 200
        self.speed = speed
        self.vy = 0
        self.on_ground = True
        self.move = True
        self.health = 100
        self.max_health = self.health
        self.alive = True

        #load debris
        self.images = []
        img = pygame.image.load('debris/cement.png').convert_alpha()
        img = pygame.transform.scale(img, (int(img.get_width()) * scale, (int(img.get_height()) * scale)))
        self.images.append(img)
        self.image = self.images[0]
        self.rect = self.image.get_rect()

    #draw debris to screen
    def draw(self):
        screen.blit(self.image,(self.x,self.y))

步骤3：修改bullet.py #

调整导入逻辑，修改update方法将debris实例作为参数传入，避免在模块顶层导入未初始化的实例：

import pygame
from config import bullet_group

#load bullets
bullets_img = pygame.image.load('car/bullet.png').convert_alpha()

#bullet class
class Bullet(pygame.sprite.Sprite):
    def __init__(self, x, y, direction):
        pygame.sprite.Sprite.__init__(self)

        self.speed = 5
        self.image = bullets_img
        self.rect = self.image.get_rect()
        self.rect.center = (x,y)
        self.direction = direction

    def update(self, debris):
        self.rect.centery -= self.speed
        #check if bullet has gone off screen
        if self.rect.top < 1:
            self.kill()
        #check collision with cement block
        if pygame.sprite.spritecollide(debris, bullet_group, False):
            if debris.alive:
                debris.health -= 25

步骤4：修改car.py #

调整导入逻辑，修复创建子弹实例的错误写法：

import pygame
from config import bullet_group, screen
import bullet

#load car image
car_img = pygame.image.load('car/car.png').convert_alpha()

#player class
class Player(pygame.sprite.Sprite):
    def __init__(self, scale, speed):
        pygame.sprite.Sprite.__init__(self)

        self.speed = speed
        self.moving = True
        self.frame = 0
        self.flip = False
        self.direction = 0

        #load car
        self.images = []
        img = pygame.transform.scale(car_img, (int(car_img.get_width()) * scale, (int(car_img.get_height()) * scale)))
        self.images.append(img)
        self.image = self.images[0]
        self.rect = self.image.get_rect()
        self.update_time = pygame.time.get_ticks()
        self.movingLeft = False
        self.movingRight = False
        self.rect.x = 465
        self.rect.y = 325

    #draw car to screen
    def draw(self):
        screen.blit(self.image, (self.rect.centerx, self.rect.centery))

    #move car
    def move(self):
        #reset the movement variables
        dx = 0
        dy = 0

        #moving variables
        if self.movingLeft and self.rect.x > 33:
            dx -= self.speed
            self.flip = True
            self.direction = -1
        if self.movingRight and self.rect.x < 900:
            dx += self.speed
            self.flip = False
            self.direction = 1

        #update rectangle position
        self.rect.x += dx
        self.rect.y += dy

    #shoot
    def shoot(self):
        new_bullet = bullet.Bullet(self.rect.centerx + 18, self.rect.y + 30, self.direction)
        bullet_group.add(new_bullet)

步骤5：重写autopilot.py #

删掉重复定义的Debris类，调整主循环逻辑适配修改后的接口：

import pygame
import car
from debris import Debris
from config import screen, bullet_group, debris_group

pygame.init()
screen.fill((255, 255, 255))

#fps
FPS = 120
clock = pygame.time.Clock()

#load images
bg = pygame.image.load('background/street.png').convert_alpha() # background

######################CAR/DEBRIS##########################

player = car.Player(1, 5)
debris = Debris(1, 5)

##########################################################

debris_group.add(debris)

#game runs here
run = True
while run:

    #draw street
    screen.blit(bg, [0, 0])

    #update groups
    bullet_group.update(debris)
    bullet_group.draw(screen)

    #draw debris
    debris.draw()

    #draw car
    player.draw()
    player.move()

    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            run = False

        #check if key is down
        if event.type == pygame.KEYDOWN:
            if event.key == pygame.K_ESCAPE:
                run = False
            if event.key == pygame.K_a:
                player.movingLeft = True
            if event.key == pygame.K_d:
                player.movingRight = True
            if event.key == pygame.K_SPACE:
                player.shoot()

        #check if key is up
        if event.type == pygame.KEYUP:
            if event.key == pygame.K_a:
                player.movingLeft = False
            if event.key == pygame.K_d:
                player.movingRight = False

    #update the display
    pygame.display.update()
    pygame.display.flip()
    clock.tick(FPS)

pygame.quit()

注意事项 #

• 不要在模块顶层导入主文件里的运行时实例，这类对象要么放到独立配置文件，要么通过参数传递
• 及时清理冗余代码，你原本在autopilot.py和debris.py中重复定义了Debris类，会提升依赖冲突概率

内容的提问来源于stack exchange，提问作者J.R. BEATS