单文件定义相互引用的Room与RoomPlayer类遇循环引用问题求助

你的问题源于两个类在类型注解中互相引用，Python解释器按顺序执行代码时，会出现“引用未定义类”的报错。以下是几种在同一个文件中解决问题的方案：

方案1：使用字符串形式的类型注解 #

直接在类型注解中用字符串包裹类名，让Python延迟解析类型，避免立即检查类是否存在。

修改Room类的相关方法：

async def player_joined(self, player: 'RoomPlayer'):
    await write_to_room_file(self.owner_user_id, 'players', {player.name: player.user_id})
    self.players[self.player_amount] = player
    player.room_player_id = self.player_amount
    self.player_amount += 1

async def player_left(self, player: 'RoomPlayer'):
    await write_to_room_file(self.owner_user_id, 'players', {player.name: player.user_id})
    self.players.pop(player.room_player_id)
    player.room_player_id = 0
    self.player_amount -= 1

async def send_message(self, sender: 'RoomPlayer'):
    for player in self.players.values():  # 修正：遍历字典值获取RoomPlayer实例
        if player != sender:
            pass

修改RoomPlayer类的类型注解：

class RoomPlayer:
    name: str
    room_player_id: int
    user_id: str
    connected_room: 'Room'  # 用字符串引用Room类
    last_message: types.Message

    def __init__(self, name: str, user_id: str, room: 'Room'):
        self.name = name
        self.user_id = user_id
        self.connected_room = room

    async def set_last_message(self, new_message: types.Message):
        self.last_message = new_message
        await self.connected_room.send_message(self)

方案2：启用annotations未来特性（Python 3.7+） #

在文件顶部添加导入语句，让所有类型注解自动延迟解析，无需手动加引号：

from __future__ import annotations

之后就可以直接使用类名作为类型注解，无需修改原有代码的注解部分：

# Room类中
async def player_joined(self, player: RoomPlayer):
    ...

# RoomPlayer类中
connected_room: Room
def __init__(self, name: str, user_id: str, room: Room):
    ...

方案3：前向声明类并调整定义顺序 #

先声明其中一个类的空壳，再定义另一个类，最后补全第一个类的完整实现：

# 前向声明Room类
class Room:
    pass

class RoomPlayer:
    name: str
    room_player_id: int
    user_id: str
    connected_room: Room
    last_message: types.Message

    def __init__(self, name: str, user_id: str, room: Room):
        self.name = name
        self.user_id = user_id
        self.connected_room = room

    async def set_last_message(self, new_message: types.Message):
        self.last_message = new_message
        await self.connected_room.send_message(self)

# 补全Room类的完整实现
class Room:
    name: str
    maxPlayers: int
    players: dict = {}
    player_amount: int = 0
    isPrivate: bool
    owner_user_id: str
    owner_username: str

    def __init__(self, name: str, owner_username: str, owner_user_id: str, private: bool, maxPlayers: int = 4):
        self.name = name
        self.maxPlayers = maxPlayers
        self.isPrivate = private
        self.owner_username = owner_username
        self.owner_user_id = owner_user_id
        rooms.append(self)
        logging.debug(rooms)

    def __del__(self):
        rooms.remove(self)

    async def player_joined(self, player: RoomPlayer):
        await write_to_room_file(self.owner_user_id, 'players', {player.name: player.user_id})
        self.players[self.player_amount] = player
        player.room_player_id = self.player_amount
        self.player_amount += 1

    async def player_left(self, player: RoomPlayer):
        await write_to_room_file(self.owner_user_id, 'players', {player.name: player.user_id})
        self.players.pop(player.room_player_id)
        player.room_player_id = 0
        self.player_amount -= 1

    async def send_message(self, sender: RoomPlayer):
        for player in self.players.values():
            if player != sender:
                pass

额外提示 #

原代码中Room.send_message方法遍历self.players时，默认会遍历字典的键（即player_amount的数值），应该改为self.players.values()才能获取到RoomPlayer实例，否则无法进行后续的玩家判断操作。

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