符合标准规范的Python类需遵循PEP 8：类名用PascalCase（如User），__init__仅赋值无副作用，实例属性须在__init__中全部声明，多重继承时显式继承object。
Python 3 中定义“符合标准规范”的类，核心不是语法正确，而是遵循 PEP 8 和 Python 惯例——尤其是 __init__ 的参数设计、属性初始化方式、以及是否需要显式继承 object。
类名必须用 PascalCase，且不加 Base 或 Class 后缀
PEP 8 明确要求类名使用首字母大写的驼峰命名（PascalCase），这是最易被忽略的硬性规范。常见错误是写成 user_manager（下划线）、UserManagerClass（冗余后缀）或 BaseUser（除非真是抽象基类）。
正确示例：User、HTTPClient、ConfigLoader；错误示例：user、user_manager、UserClass。
__init__ 中只做必要属性赋值，避免副作用
很多新手在 __init__ 里直接调用外部 API、读文件、启动线程——这会让实例化变得不可预测且难以测试。规范做法是：仅用 self.xxx = xxx 绑定传入参数或默认值，把耗时/副作用逻辑拆到单独方法中。
- ✅ 推荐：
def __init__(self, name: str, timeout: int = 30): self.name = name; self.timeout = timeout - ❌ 避免：
def __init__(self): self.data = requests.get(...)或threading.Thread(...).start() - ⚠️ 注意：类型注解应与参数一一对应，未标注的参数会被静态检查工具（如 mypy）视为
Any
显式继承 object 已非必需，但多重继承时必须显式写 object
Python 3 中所有类默认隐式继承 object，所以 class User: 和 class User(object): 完全等价。但若涉及 super() 或 MRO（方法解析顺序），尤其在多重继承场景下，省略 object 可能导致意外行为（比如旧式类语义残留，尽管 Python 3 已无旧式类，但部分动态代码生成库仍依赖显式声明）。
稳妥写法：class User(BaseModel, Serializable, object): —— 最右的 object 显式锚定 MRO 底层，避免某些元类操作出错。
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
实例属性应在 __init__ 中全部声明，哪怕初始值为 None
动态添加属性（如在某个方法里突然写 self.cache = {}）会破坏 IDE 类型推导、使 __slots__ 失效、并让 dataclasses 或 pydantic 模型校验失败。规范要求：所有可能访问的实例属性，必须在 __init__ 开头集中初始化。
示例：
def __init__(self, name: str):
self.name = name
self._cache = None # 即使暂不用，也先声明
self._retry_count = 0
这样后续方法中赋值 self._cache = {} 才属于“赋值”而非“首次创建”，对调试、序列化、文档生成都更友好。
真正容易被跳过的点是：**属性声明的完整性**和**__init__ 的纯度**。很多人能写出语法合法的类，但一跑单元测试就发现属性未定义、初始化逻辑耦合过重、或者继承链上 super().__init__() 调用遗漏——这些都不是报错问题，而是维护成本暴增的伏笔。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
