Python 编码风格

此文件扩展了 common/coding-style.md，包含 Python 特定内容。

标准

• 遵循 PEP 8 规范
• 所有函数签名使用类型注解

不可变性

优先使用不可变数据结构：

from dataclasses import dataclass

@dataclass(frozen=True)
class User:
    name: str
    email: str

from typing import NamedTuple

class Point(NamedTuple):
    x: float
    y: float

格式化

• black 用于代码格式化
• isort 用于导入排序
• ruff 用于 linting

参考

参见 skill：python-patterns 了解全面的 Python 惯用法和模式。