静态方法是最干净的工具函数挂载方式，因其输入输出确定、无状态依赖、不创建实例，适合数据转换、数值计算等纯逻辑场景，应通过类名调用且方法体内禁用self/cls。
直接用 @staticmethod 装饰器定义方法，参数只写业务需要的，不带 self 或 cls，调用时走 类名.方法名() —— 这就是最干净的挂载方式。
为什么适合挂工具函数
工具函数的核心特征是：输入确定、输出确定、不读写任何对象状态、无副作用。静态方法天然匹配这个定位——它被组织在类名下，逻辑归属清晰，又完全脱离实例生命周期。
- 避免为一次调用创建无意义的实例（比如
new StringUtils()） - 命名空间集中管理，比散落的全局函数更易发现和维护
- 继承体系中可被子类覆盖或复用，保持扩展性
怎么写才规范
重点不在“能运行”，而在“意图明确、边界清晰、不易误用”：
- 方法体里不出现
self.xxx或cls.xxx，否则就该改用实例方法或类方法 - 参数类型尽量选不可变值（
str、int、float、tuple），避免传入可变对象后被意外修改 - 做基础校验：空值、负数、非法格式提前抛错，不把问题留给下游
- 类本身无需实例化，Java 中会加私有构造函数，Python 虽无强制，但习惯上不写
__init__或留空即可
常见使用场景举例
以下都是真实项目中高频出现的静态方法用途：
-
数据转换：如
parse_date(string, fmt)、to_snake_case(name)，输入字符串，输出结构化结果 -
数值计算：如
calculate_tax(amount, rate)、is_prime(n)，纯数学逻辑，无外部依赖 -
字符串/格式处理：如
mask_phone(phone)、truncate(text, max_len)，操作独立、结果可预测
调用时注意什么
推荐且默认的方式只有一种：通过类名调用。
- ✅
PriceCalculator.apply_discount(100, 0.1)—— 意图清晰，不产生冗余对象 - ⚠️
calc = PriceCalculator(); calc.apply_discount(100, 0.1)—— 语法合法，但违背设计本意，容易误导后续维护者
如果某个“工具方法”突然需要访问类属性或配置，说明它已超出静态方法职责，应重构为类方法或引入依赖注入。
