Python 3.12泛型新语法需用type Stack[T] = list[T]声明，T自动绑定；f-string引号限制取消但表达式仍须语法完整；@override依赖类型检查器且父类方法须有类型注解；distutils已移除，须迁至pyproject.toml和新版setuptools。
泛型类型参数语法（PEP 695）怎么写才不报错
Python 3.12 引入了更简洁、更接近其他静态语言的泛型声明方式，替代过去冗长的 Generic[T] + TypeVar 组合。关键不是“能不能用”，而是写法稍有偏差就会被类型检查器（如 mypy）或解释器拒绝。
常见错误现象：NameError: name 'T' is not defined 或 mypy 报 Invalid type alias，往往是因为在 type 语句中直接用了未声明的类型变量。
- 正确写法必须用新语法声明类型参数：
type Stack[T] = list[T]，T是自动绑定的类型参数，不用提前from typing import TypeVar - 旧写法
Stack = list[T]（没加type关键字）在 3.12 中仍可运行但不被类型检查器识别为泛型别名 - 嵌套泛型支持更自然，比如
type Pair[K, V] = tuple[K, V]，而不用再写tuple[K, V]配合Generic[K, V]类定义 - 函数级泛型也支持新语法：
def first[T](items: list[T]) -> T:，注意这里T不需要引号，也不需要TypeVar
f-string 嵌套引号和表达式限制彻底放开（PEP 701）
3.11 及以前版本中，f-string 内部若出现与外层相同引号，会直接 SyntaxError；3.12 彻底移除了该限制——但这不是鼓励乱写，而是让合法表达式不再被语法解析器误杀。
使用场景：拼接含双引号的 JSON 字段、生成带引号的 SQL 片段、嵌套调用含字符串字面量的函数。
立即学习“Python免费学习笔记（深入）”；
- 允许：
f"key: {json.dumps({'name': 'Alice'})}"—— 外层双引号，内层json.dumps返回含双引号字符串，3.11 会报错，3.12 正常 - 允许多层嵌套 f-string：
f"{f'{f'hello'}'}"，但实际开发中应避免，可读性差且无性能收益 - 仍不允许在表达式部分使用未闭合引号：
f"{x = 'abc"依然 SyntaxError，PEP 701 解决的是“引号配对冲突”，不是“语法完整性” - 注意：运行时性能不变，只是编译阶段解析更宽松；mypy 等工具需升级到支持 PEP 701 的版本（≥1.5.1）才能正确校验
@override 装饰器如何配合类型检查生效
@override 不是运行时强制机制，它的价值完全依赖静态类型检查器（如 mypy、pyright）。不配类型检查，它就只是个无操作装饰器。
容易踩的坑：写了 @override 却没开类型检查，或父类方法签名改了但子类没同步更新，结果毫无提示。
- 必须从
typing导入：from typing import override（不是typing_extensions，3.12 已内置） - 父类方法必须有明确的类型注解（哪怕只注返回值），否则 mypy 无法判断是否真正 override；例如
def get_id(self) -> int:才行，def get_id(self):会被忽略 - 子类方法签名必须严格一致（参数名、默认值、返回类型），连
self的类型注解差异（如SelfvsAny）都可能触发警告 - IDE 支持尚不统一：VS Code + Pylance 已支持，但 Vim/Neovim 用户需确认 lsp 服务已加载 3.12 元数据
distutils 移除后，setup.py 和构建流程怎么过渡
distutils 在 3.12 中被正式移除，不是弃用警告，而是 Import Error。所有依赖它的构建脚本、CI 配置、甚至某些老版本 setuptools 插件都会崩。
这不是“升级 Python 就能自动修好”的问题，而是构建链路重构。
- 立即检查是否有直接
import distutils或from distutils.*，全部替换为setuptools对应模块（如setuptools.command.build） -
setup.py应迁移到pyproject.toml：用[build-system]指定requires = ["setuptools>=61.0", "wheel"]，并删除setup.py文件本身（除非必须兼容极老环境） - 若用
pip install -e .开发安装，确保setuptools≥ 64.0，否则可能静默失败 - CI 中常见错误：
ModuleNotFoundError: No module named 'distutils.cmd'，说明某处间接依赖了旧版打包工具，需查pip list并升级相关插件（如twine、build）
distutils 调用——它们不会在你的代码里报错，却会让整个构建在 3.12 下突然失败。建议用 python -c "import setuptools; print(setuptools.__version__)" 和 pipdeptree --reverse --what setuptools 交叉验证依赖树。 
