Python类型注解未解析引用：为何找不到WeekDay类？需创建同名类？

这问题我之前也踩过坑！本质是Python类型注解的解析时机在搞鬼——当你在get_week_days方法的返回注解里写Dict[str, WeekDay]时，Python解释器还没完成WeekDay类的完整定义呢，自然找不到这个类名。你说创建另一个同名类能消除报错，其实是因为那个新类已经被解析完成，类型检查器找到了它，但这完全是绕弯路的错误做法。

问题根源 #

Python解析类定义是从上到下逐行执行的。当解析到get_week_days方法的返回类型注解时，WeekDay类还没被完全定义（类的定义要到整个class代码块结束才会完成），所以静态类型检查工具（比如PyCharm的代码检查、mypy）就会抛出“未解析引用”的错误。

正确的解决办法 #

这里有几种靠谱的方案，根据你的Python版本选择就行：

1. 字符串形式的类型注解（兼容所有Python版本） #

把注解里的WeekDay改成字符串"WeekDay"，这样类型检查器会延迟解析这个类名，等类定义全部完成后再识别：

from typing import Dict

class WeekDay:
    def __init__(self, day_number, day_name):
        self.day_name = day_name
        self.day_number = day_number

    @staticmethod
    def get_week_days() -> Dict[str, "WeekDay"]:  # 用字符串包裹类名
        weekdays = {
            "monday": WeekDay(1, "Monday"),
            "tuesday": WeekDay(2, "Tuesday"),
            "wednesday": WeekDay(3, "Wednesday"),
            # 补充剩余日期...
        }
        return weekdays

2. 使用Self类型注解（Python 3.11+） #

从Python 3.11开始，typing模块新增了Self类型，专门用来指代类自身，用它替代WeekDay更直观清晰：

from typing import Dict, Self

class WeekDay:
    def __init__(self, day_number, day_name):
        self.day_name = day_name
        self.day_number = day_number

    @staticmethod
    def get_week_days() -> Dict[str, Self]:  # 用Self指代当前类
        weekdays = {
            "monday": WeekDay(1, "Monday"),
            "tuesday": WeekDay(2, "Tuesday"),
            "wednesday": WeekDay(3, "Wednesday"),
            # 补充剩余日期...
        }
        return weekdays

3. 用TypeVar绑定类（兼容Python 3.6-3.10） #

如果你用的是Python 3.6到3.10之间的版本，可以用TypeVar创建一个绑定到当前类的类型变量：

from typing import Dict, TypeVar

T = TypeVar("T", bound="WeekDay")

class WeekDay:
    def __init__(self, day_number, day_name):
        self.day_name = day_name
        self.day_number = day_number

    @staticmethod
    def get_week_days() -> Dict[str, T]:
        weekdays = {
            "monday": WeekDay(1, "Monday"),
            "tuesday": WeekDay(2, "Tuesday"),
            "wednesday": WeekDay(3, "Wednesday"),
            # 补充剩余日期...
        }
        return weekdays

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