Java不支持默认参数，可用方法重载或Builder模式模拟：重载适用于参数少、类型明确场景，需确保仅一个全参方法实现逻辑；Builder适用于多可选参数、存在依赖或互斥关系的复杂场景。
Java 本身不支持像 Python 或 Kotlin 那样的默认参数语法（比如 void foo(String s, int x = 10)），所以不能直接写“方法参数默认值”。但你可以用两种主流方式模拟：方法重载（overloading）和可选参数模式（通常配合 Builder 或 Optional、对象封装）。关键看你要的是编译期简洁性，还是运行期灵活性。
用方法重载模拟默认参数最常用也最安全
这是 Java 社区最广泛接受的做法，编译器能静态检查，IDE 支持好，调用时语义清晰。核心是写多个同名方法，参数数量或类型不同，让参数少的版本调用参数多的版本并填入默认值。
常见错误现象：
- 把所有重载方法都实现完整逻辑，导致重复代码和维护困难；
- 重载组合爆炸（比如 4 个参数，每个都有默认值，可能要写 16 个方法）——这时该换模式。
实操建议：
- 只保留一个“全参数”方法作为主实现，其他重载方法都转发给它
- 默认值写在重载方法体内，不要抽成常量再到处引用（除非是真全局配置）
- 避免仅靠参数顺序差异重载（比如
foo(int a, String b)和foo(String a, int b)），易读性差且容易歧义
示例：
立即学习“Java免费学习笔记（深入）”；
public void connect(String host) {
connect(host, 8080, false);
}
<p>public void connect(String host, int port) {
connect(host, port, false);
}</p><p>public void connect(String host, int port, boolean ssl) {
// 真正干活的逻辑
System.out.println("Connecting to " + host + ":" + port + " (ssl=" + ssl + ")");
}</p>用对象封装 + 构建者模式处理复杂可选参数
当方法有 3 个以上参数，其中多个可选、类型混杂、甚至存在互斥或依赖关系时，重载会迅速失控。这时候应把参数收进一个配置类，用 Builder 模式构造。
使用场景：
- HTTP 客户端请求配置（timeout、headers、auth、retry 等）
- 数据库查询选项（fetchSize、readOnly、queryTimeout）
- UI 组件初始化（visible、enabled、tooltip、icon）
实操建议：
- Builder 类最好设为配置类的静态内部类，保持内聚
- Builder 的
build()方法应做必要校验（如必填字段缺失时抛IllegalStateException） - 避免在 Builder 中暴露 setter 返回
void；链式调用必须返回this
示例简写：
public class HttpRequest {
final String url;
final int timeout;
final Map<String, String> headers;
<pre class="brush:php;toolbar:false;">private HttpRequest(Builder builder) {
this.url = builder.url;
this.timeout = builder.timeout;
this.headers = Collections.unmodifiableMap(builder.headers);
}
public static class Builder {
private String url;
private int timeout = 5000; // 默认值在这里
private final Map<String, String> headers = new HashMap<>();
public Builder url(String url) { this.url = url; return this; }
public Builder timeout(int ms) { this.timeout = ms; return this; }
public Builder header(String k, String v) { headers.put(k, v); return this; }
public HttpRequest build() { return new HttpRequest(this); }
}}
// 调用： HttpRequest req = new HttpRequest.Builder() .url("https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39") .header("Accept", "application/json") .build(); // timeout 自动用 5000
别滥用 Optional 作为方法参数的“默认值占位符”
有人试图用 Optional<string> name</string> 表示“可选”，再在方法里判空赋默认值。这看似灵活，但实际带来三个问题：
常见错误现象：
- 调用方必须写 Optional.of("xxx") 或 Optional.empty()，比直接传 null 还啰嗦；
- Optional 设计本意是作为返回值，用于明确表达“可能无值”的计算结果，不是为参数设计的；
- 无法区分“用户显式传空”和“根本没传”，语义模糊。
实操建议：
- 如果参数本质是可空的业务概念（比如“上级部门ID 可为空”），直接用
String parentId+ 注释/Javadoc 说明即可 - 真需要运行时动态决定是否用默认值，放到方法内部做判断（比如
if (name == null) name = "default"），而不是推给调用方包一层Optional - 只有当你需要把“未设置”作为一种状态参与后续流程（比如配置合并逻辑）时，才考虑自定义一个
Missing<t></t>类型，而非硬套Optional
真正难的不是选哪种方式，而是判断什么时候该从重载切换到 Builder：参数超过 3 个、出现布尔标志组合（如 verbose, trace, dryRun）、或者默认值依赖上下文（比如从配置中心读）。这些信号一出现，就别硬撑着加第 7 个重载方法了。
