python方法默认参数必须非默认参数在前、避免可变对象陷阱、动态值用none占位、重视ide支持与类型提示，显式优于隐式。
直接在类方法里写 def method(self, x=1, y="default") 没问题，但“优雅”取决于你是否预判了可变对象陷阱、调用歧义和 IDE 支持损耗。
默认参数必须放在非默认参数之后
这是语法硬性要求，不是风格建议。Python 解析器按位置匹配实参，一旦出现默认参数在前，立刻报 SyntaxError。
- 错误写法：
def update_user(self, name=None, age):→ 直接无法定义 - 正确顺序：
def update_user(self, age, name=None, email=None): - 混合
*args和**kwargs时，顺序必须是：self, a, b=1, *args, c=2, **kwargs
别用可变对象（list/dict）做默认值
所有调用共享同一个对象实例，后续修改会污染下一次调用 —— 这是最常被忽略的坑，且只在运行时暴露。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 危险示例：
def add_tag(self, tag, tags=[]): tags.append(tag); return tags - 第一次调用返回
["a"]，第二次变成["a", "b"]，不是["b"] - 安全写法：
def add_tag(self, tag, tags=None): tags = tags or []或更明确地tags = [] if tags is None else tags
动态值（如时间、随机数）要用 None 占位
默认值在函数定义时求值一次，datetime.now() 或 uuid.uuid4() 不会每次调用都刷新。
- 错误：
def log(self, msg, ts=datetime.now()):→ 所有调用都用同一时间戳 - 正确：
def log(self, msg, ts=None): ts = ts or datetime.now() - 如果
None是合法业务值（比如允许时间为空），改用ts=...（Ellipsis）或自定义哨兵对象
IDE 和类型提示友好性比想象中重要
哪怕加了 def process(self, data: dict, timeout: int = 30)，IDE 仍无法推断 data 字典里有哪些 key；而显式参数能触发自动补全和类型检查。
- 字段固定、语义清晰（如
retries,timeout）→ 坚持显式声明 - 字段多且易变（如 API 响应映射类的初始化）→ 改用
**kwargs+ 白名单过滤，而非堆默认参数 - 类型注解要同步更新：
def send(self, to: str, subject: str = "", body: str = "") -> bool:
最常被忽略的一点：默认参数让调用方失去了“必须看文档才知道哪些可省略”的强制提醒——它悄悄把接口契约从显式变成了隐式。所以别为了少敲几个字，把本该由参数名承载的语义，压进默认值里。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
