当方法参数超过4～5个，尤其含多个同类型时，应重构为参数对象；需命名带业务上下文、优先不可变、校验前移、用builder模式、对可变类型做保护性拷贝。
方法签名参数一多，就容易看花眼、传错顺序、改起来战战兢兢——这不是风格问题，是设计信号。当一个方法参数超过 4～5 个，尤其含多个同类型（比如三个 String、两个 long），基本就该动手重构了。
识别该出手的“危险信号”
别等出 Bug 才反应过来。以下情况出现任意一条，就是参数列表已失控的明确提示：
- 调用时得反复对照方法定义才能确认第四个参数是
tenantId还是locale - 同一组参数（如
startTime、endTime、timezone）在多个地方重复传入 - 参数之间有隐含约束（比如
minPrice ），但签名完全不体现 - 新增一个可选参数，就得加一个重载方法，接着再加一个……循环开始
用参数对象（Parameter Object）替代裸参数
不是简单把参数塞进一个 Map<string object></string>，而是封装成有业务含义、带约束逻辑的类。例如搜索场景，别叫 SearchParam，而应命名为 ProductSearchRequest：
- 字段命名带上下文：用
categoryIds而非ids，用isPreviewMode而非flag - 优先不可变：字段声明为
final，通过构造器或 Builder 初始化 - 校验前移：在构造器或 Builder 的
build()中做非空、范围、逻辑一致性检查（如startTime.before(endTime)） - 避免 setter：如需修改，提供
withStartTime(Instant)这类链式方法，保持对象语义不变
配合构建器模式提升调用体验
字段较多时，直接用构造器易出错且难读。Builder 模式让调用像说话一样自然：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
ProductSearchRequest request = ProductSearchRequest.builder()
.categoryIds(List.of("laptop", "monitor"))
.priceRange(PriceRange.between(2000, 15000))
.isPreviewMode(true)
.locale("zh-CN")
.build();
IDE 自动补全友好，顺序无关，缺失必填字段编译期报错，比裸参数安全得多。
别忘了校验和保护性拷贝
参数对象内部若持有可变类型（如 Date、ArrayList），必须做防御处理：
- 构造时对入参做保护性拷贝（
new ArrayList(inputList)） - getter 方法返回不可变视图（
Collections.unmodifiableList(...)）或新副本 - 对外暴露的永远是“快照”，防止外部修改影响内部逻辑
不复杂，但容易忽略——参数列表不是越全越好，而是越清晰、越安全、越贴近业务才越好。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
