最稳解法是用模块全路径访问类而非from...import同名类，因导入即变量赋值会导致后导入覆盖前导入，引发isinstance误判、attributeerror等；应使用import auth.models和import billing.models或带业务上下文的别名。

直接用模块全路径访问类，别用 from ... import 导入同名类——这是最稳的解法，不是权宜之计。

类名本质是变量名，导入即赋值

Python里User不是语法关键字，它就是一个绑定在当前命名空间里的变量。当你写from auth.models import User，等于执行了User = auth.models.User；再写from billing.models import User，就等价于User = billing.models.User，前一个被覆盖，且不报错。

常见后果包括：

• isinstance(obj, User) 返回 False，哪怕 obj 真是 auth.models.User 的实例
• 调用 obj.some_method() 报 AttributeError，因为实际类型是另一个 User
• Django 的 models.py 被自动扫描时，只留下最后导入的那个类

用模块全路径代替 from import

显式写清来源，既避免覆盖，也提升可读性和 IDE 支持。

正确做法：

import auth.models
import billing.models
<p>u = auth.models.User()
v = billing.models.User()
</p>

如果路径太长，可用带业务上下文的别名：

import auth.models as auth_models
import billing.models as billing_models
<p>u = auth_models.User()
v = billing_models.User()
</p>

不要写成 import auth.models as models——这又把冲突引回本地命名空间。

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

包内 __init__.py 暴露类要特别小心

很多项目习惯在 api/__init__.py 里集中导出：

# api/__init__.py
from .v1.user import User
from .v2.user import User  # ❌ 静默覆盖

结果只有 v2 的 User 可用。可行方案有：

• 不在顶层 __init__.py 中导入同名类
• 显式重命名：from .v1.user import User as UserV1 和 from .v2.user import User as UserV2
• 更推荐：让使用者按需导入具体子模块，比如 from api.v1.user import User

类属性注解中与类名同名会触发作用域陷阱

当类属性名和外部类名相同时，类型注解里的 | 运算会误解析为局部变量（尚未完成赋值的 None），导致 None | None 报错。

例如：

class A:
    pass
<p>class B:
A: A | None = None  # ❌ TypeError
</p>

安全写法包括：

• 重命名属性：a_instance: A | None = None
• 字符串延迟注解：A: "A | None" = None
• 显式模块限定：A: __main__.A | None = None（仅适用于 __main__）

这个坑不常踩，但一旦触发，错误信息完全不指向根本原因，容易卡很久。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！