Python Language 是一个面向 Python 3.11+ 的语言层编码规范技能,标注为 P0(关键)优先级,目标是在编写 Python 模块时使用地道的语言构造。
用途:作为编码规范约束,指导类型标注、数据契约建模、导入组织、路径操作与标准库使用方式,减少自定义包装和类型逃逸。
主要能力(规则要点):
- 现代模块优先使用 from future import annotations。
- 为公开函数、返回值以及边界数据形状添加类型标注。
- 优先使用 pathlib.Path、contextlib、enum 和标准库辅助工具,再考虑自定义包装。
- 使用 @dataclass(frozen=True) 表达不可变契约与值对象。
- 优先使用 Protocol、TypedDict 或小型 dataclass,替代 dict[str, Any] 式的散乱结构。
使用方式(Recipe 要点):
- 在 I/O 边界用 dataclass、typed dict 或 pydantic 显式建模契约。
- 保持导入稳定,顺序为:标准库、第三方、本地。
- 谨慎使用推导式与生成器,可读性下降时停止。
- 持久化或面向用户的时间戳选用显式带时区的 datetime。
- 保持模块副作用最小,导入时不应启动实际工作。
反模式(Anti-Patterns):
- 不使用可变默认值,改用 field(default_factory=...)。
- 新代码不使用 os.path,优先 Path。
- 不用 Any 作为逃生舱;对未知形状收窄或校验。
- 除非有意缓存配置,否则不在导入时读取易变运行时状态的环境变量。
验证:跨模块类型变更后运行解析器/类型检查;加载 Framework Map 获取分类默认值。
适用场景:编写或审查 Python 模块、定义数据契约与值对象、组织导入与路径处理、在团队内统一 Python 语言层规范。
限制:资料仅描述语言规范与反模式,未提供安装命令、CLI 用法、收费、支持平台或效果数据,这些信息暂未提供。