方法参数超3–5个应考虑重构：优先封装为语义相关的不可变参数对象（如productsearchrequest），辅以builder模式和构造校验；按内聚性可分层拆分为小对象（如fullname、address）；慎用重载与varargs，避免布尔标志过多；单一意图方法无需强行封装。
方法参数超过 3–5 个，基本就该考虑重构了。不是硬性限制，而是信号：逻辑在变散、调用易出错、维护成本正在上升。
优先封装成参数对象（Parameter Object）
当多个参数语义相关（比如都属于“搜索条件”或“用户注册信息”），直接打包成一个不可变类最自然。例如把 categoryIds、keyword、offset、limit 合并为 ProductSearchRequest，签名从冗长变成清爽的 search(ProductSearchRequest req)。
- 构造时做基础校验（如
limit截断到 1–100，keyword自动 trim） - 用 builder 模式提升可读性，避免构造函数里堆 null 判断
- 旧方法别删，先加新重载，内部转调新接口，再逐步迁移调用方
按内聚性分组，再逐层封装
不是所有参数都必须塞进一个大对象。比如创建用户时有“姓名字段”“地址字段”“状态字段”，可以拆成 FullName、Address、UserStatus 三个小对象，再由顶层对象组合。这样既降低单个类复杂度，又保留语义清晰度。
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 称呼、名、姓、后缀 →
FullName - 街道、城市、省份 →
Address - 是否在职、是否房主、性别 → 可合并为
UserProfile或保持布尔字段直传（若仅 2–3 个且无扩展需求）
慎用重载和 varargs，明确适用边界
重载适合提供不同粒度的调用入口（如 save(User) 和 save(User, boolean flushCache)），但别搞伸缩构造器式堆叠；varargs 只适用于真正同质、数量不定的场景（如日志方法 log(String format, Object... args)），不能用来掩盖设计问题。
- 避免为“可选参数”堆十几个重载，那只是把混乱从调用处转移到定义处
- varargs 参数必须是末尾，且类型唯一，否则调用歧义风险高
- 布尔标志位多于 2 个，大概率说明职责不清，该拆或该建枚举
简单场景不硬套，留白比过度设计更健康
不是每个方法都要参数对象。像 findById(Long id)、isAdult(int age) 这类单一意图、参数天然独立的方法，加一层包装反而增加噪音。
- 判断标准：参数之间有没有强关联？将来是否可能一起变更或扩展？
- 如果某个“参数对象”只被一个方法使用，且未来几乎不会复用，先观望
- 团队能快速理解、修改、测试，比教条遵守数字更重要
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
