这是个典型的**前向引用（forward reference）**问题——Python解释器是从上到下执行代码的，当解析到X类的add_member方法时，User类还没被定义，所以PyCharm会抛出未解析引用的错误。下面有几个实用的解决办法：

方法1：使用字符串形式的类型提示 #

直接把类型提示里的User用引号包裹起来，这是Python 3.5+就支持的语法，PyCharm也能完美识别：

class X(models.Model):
    def add_member(self, user: 'User'):
        # 你的代码逻辑

方法2：导入from __future__ import annotations（Python 3.7+推荐） #

在文件顶部添加这个导入语句后，所有类型提示会被当作字符串处理，直到运行时才会解析，彻底解决前向引用问题，写法也更简洁：

from __future__ import annotations
from django.db import models
from django.contrib.auth.models import AbstractUser

class X(models.Model):
    def add_member(self, user: User):
        # 你的代码逻辑

class User(AbstractUser):
    # User类的代码

方法3：调整类定义顺序（仅适用于无反向依赖的场景） #

如果User类和X类之间没有互相引用的情况，可以把User类移到X类前面定义，这样解析X时User已经存在了：

class User(AbstractUser):
    # User类的代码

class X(models.Model):
    def add_member(self, user: User):
        # 你的代码逻辑

不过如果User里也需要引用X，这个方法就会触发新的前向引用问题，所以更推荐前两个方案。

内容的提问来源于stack exchange，提问作者Roberto Fernandez Diaz