静态方法应严格满足三原则：不访问任何外部状态、不修改外部数据、相同输入恒定输出；按功能分组为mathtools/strtools/validatetools等，命名清晰、职责单一；参数需校验并抛出具体异常；调用统一用类名.方法名()。
直接用 @staticmethod 装饰器定义方法，不传 self 或 cls，只接收业务参数，输入决定输出，不读写任何外部状态——这是封装纯数学计算与字符串加工工具的核心原则。
明确静态方法的适用边界
只有满足以下三点，才适合做成静态方法：
- 完全不访问实例属性、类属性或全局变量
- 不修改任何外部数据（比如不改变传入的列表、不写文件、不发请求）
- 相同输入永远返回相同输出（可预测、可复现）
例如：math.ceil() 类似的四舍五入、字符串去空格并转小写、判断邮箱格式是否合法——这些都符合；但涉及数据库查询、调用随机数生成器（除非固定 seed）、或依赖当前时区的日期处理，就不算“纯”。
按功能分组，命名清晰，避免大而全的工具类
不要把所有工具塞进一个 Utils 类。按语义拆分，让调用者一眼知道该用哪个类：
-
MathTools：圆面积、阶乘、最大公约数、向量点积 -
StrTools：驼峰转下划线、截断超长文本、安全 HTML 转义 -
ValidateTools：手机号校验、密码强度检查、JSON 字符串合法性预判
每个类内部方法保持单一职责，比如 StrTools.truncate(text, max_len, ellipsis="…") 只做截断，不附带日志或埋点逻辑。
参数校验与错误提示要务实
静态方法没有实例上下文，出错时需靠自身提供清晰反馈：
- 对关键参数做类型和范围检查，比如半径不能为负、字符串不能为
None - 抛出具体异常（
ValueError、TypeError），而不是模糊的Exception - 错误信息说明“什么错了、为什么错、怎么改”，例如：
"max_len must be positive integer, got -5"
示例：MathTools.calculate_circle_area(5) 正常返回；传 -2 就立刻报错，不默默返回负值或静默失败。
调用方式统一走类名，不通过实例
静态方法的意义在于“脱离实例存在”，所以始终用 类名.方法名()：
- ✅ 推荐：
area = MathTools.calculate_circle_area(7) - ❌ 不推荐：
m = MathTools(); area = m.calculate_circle_area(7)—— 多此一举，还容易误导后续维护者以为该方法可能依赖实例状态
即使在单元测试中，也直接调用类方法，便于隔离验证逻辑本身，无需构造模拟对象。
