Python 3.12 引入了 class Bag[T]: 这一原生泛型语法（PEP 695），作为对传统 typing.Generic[T] 模式的语法糖；它在运行时行为完全等价，但显著提升了可读性、作用域安全性与类型声明内聚性。
python 3.12 引入了 `class bag[t]:` 这一原生泛型语法（pep 695），作为对传统 `typing.generic[t]` 模式的语法糖；它在运行时行为完全等价，但显著提升了可读性、作用域安全性与类型声明内聚性。
Python 3.12 正式落地了 PEP 695 —— Type Parameter Syntax，为泛型类和函数提供了更直观、更健壮的声明方式。过去（Python ≤ 3.11），定义一个泛型类需显式导入、声明 TypeVar，再继承 Generic，代码冗长且易出错：
import typing as t
T = t.TypeVar("T") # 全局命名污染风险：T 可能被意外覆盖或重用
class Box(t.Generic[T]):
def __init__(self, value: T) -> None:
self.value = value而 Python 3.12+ 支持直接在类名后声明类型参数，语义清晰、作用域封闭：
class Box[T]:
def __init__(self, value: T) -> None:
self.value = value✅ 运行时完全等价：
两者均生成符合 typing.Generic 协议的类，__mro__、__orig_bases__ 和类型检查器（如 mypy、pyright）解析结果一致：
print(Box.__mro__) # (<class '__main__.Box'>, <class 'typing.Generic'>, <class 'object'>)
✅ 类型参数自动作用域隔离：[T] 中的 T 是局部类型参数（local type parameter），仅在 Box 类定义体内有效，不会泄漏至全局命名空间，彻底避免了旧模式中 T = TypeVar("T") 的命名冲突与误复用问题。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
✅ 支持多参数与约束/协变声明：
新语法完整支持高级泛型特性，例如：
# 多参数 + bounds + variance
class Mapping[K: str, V, *Ts](dict[K, V]):
pass
class Reader[+T]: # 协变
def get(self) -> T: ...⚠️ 注意事项：
立即学习“Python免费学习笔记（深入）”；
- 新语法仅适用于类和函数定义（
def func[T](...)），不适用于变量注解或Union[T, int]等表达式上下文； -
class C[T]: ...编译后仍会被解释器转换为等效的Generic子类（即class C(typing.Generic[T]): ...），因此与现有类型检查工具、运行时反射逻辑完全兼容； - 若需在
__init__外部引用类型参数（如Box.__type_params__），其值为(<class>,)</class>，但应优先使用标准协议（如get_args(get_origin(cls))）进行元编程。
总结而言，class MyClass[T] 在语义和运行时上等价于 class MyClass(typing.Generic[T])，但它不是简单的文本替换——而是由编译器保障的、作用域安全的、面向开发者的高阶抽象。升级至 Python 3.12 后，建议新项目统一采用 [T] 语法，既提升代码可维护性，也为未来类型系统演进（如 PEP 696 默认类型参数）奠定基础。
