default4j 通过注解处理器为 Java 添加编译期默认参数支持，零运行时开销，支持方法、构造器、record 及命名参数流式调用，大幅提升代码简洁性与可维护性。
Java 也能有默认参数了？这个神库让你告别方法重载地狱
受够了 Java 那套“方法重载”的繁琐写法？每次想加一个可选参数，就得手写一堆重载方法，不仅代码冗长，还容易出错。更别提那些动不动就七八个参数的构造函数，调用起来眼睛都看花了。
好消息来了！GitHub 上有个叫 default4j 的开源项目，直接给 Java 加上了默认参数的功能，而且完全在编译期搞定，零运行时开销，简直不要太爽！
它的作者是俄罗斯开发者 Alexey Rukhin（中文圈常称他为鲁金），一位长期活跃在 JVM 生态的极客，热衷于用精巧的注解处理器解决 Java 语言本身的限制。他之前还做过不少工具类库，这次推出的 default4j 更是直击 Java 开发者的痛点——终于不用再羡慕 Kotlin 或 Python 的默认参数语法了！
编译期自动生成代码，Java 原生无侵入
default4j 的核心原理非常聪明：它不修改 Java 语言本身，而是利用 Java 的注解处理器（Annotation Processor）机制，在你编译代码的时候，自动分析你标注了特殊注解的方法或构造器，然后生成辅助类和调用方法。
这意味着你的运行时完全干净，没有任何反射、代理或者额外依赖，性能毫无损失。打个比方，你写一个带默认值的方法，编译完之后，default4j 会悄悄生成一个叫 GreeterDefaults 的类，里面包含各种参数组合的静态方法。你调用时直接用这个生成类，就像在用原生支持默认参数的语言一样自然。这种“编译时魔法”既安全又高效，完全符合 Java 工程师对稳定性和性能的严苛要求。更重要的是，它对现有代码零侵入——你只需要加上几个注解，剩下的交给工具就行。
用 @DefaultValue 轻松定义默认值，调用方式超直观
用法简单到离谱。你只需要在方法参数上加上 @DefaultValue 注解，填上默认值就行。比如下面这个打招呼的方法：
public class Greeter { |
加上 @WithDefaults 注解表示这个方法需要生成默认参数支持。编译后，你可以这样调用：
GreeterDefaults.greet(g); // 输出 Hello, World! |
看懂了吗？参数从左到右依次可省略，省略的部分就用你定义的默认值代替。再也不用写三个重载方法了！这种模式特别适合那些参数多但大部分都有合理默认值的场景，比如网络请求配置、日志记录器初始化、工具函数封装等等。而且因为是编译期生成，IDE 还能自动提示这些生成的方法，写代码时丝滑流畅，毫无违和感。
命名参数 + 流式调用？Java 居然也能这么 Modern！
更炸裂的是，default4j 还支持命名参数风格的流式调用！你只需要在 @WithDefaults 注解里加上 named = true，它就会生成一个 Builder 风格的辅助类。这意味着你可以跳过中间某些参数，只设置你关心的那几个，顺序也不用死板。举个数据库连接的例子：
DatabaseDefaults.connect(db) |
这里，port、password、timeout 等参数可能都有默认值，你完全不用管。想改哪个就链式调用哪个，最后 call() 执行。这种写法不仅可读性爆表，还极大提升了代码的可维护性——以后加新参数，老调用代码完全不用动！这不就是我们梦寐以求的“现代语言体验”吗？要知道，Java 语言本身要到很晚才考虑加入类似特性，而 default4j 用纯工具链的方式提前实现了，还做得这么优雅。
构造器和 Record 也不放过，工厂方法一键生成
你以为它只支持普通方法？太小看它了！default4j 同样支持构造器和 Java 14 引入的 record 类型。你可以在构造器参数上标注默认值，然后它会自动生成一个叫 UserDefaults.create() 的工厂方法。比如：
User u1 = UserDefaults.create("Alice"); // email 和 role 用默认值 |
这对于构建不可变对象尤其有用。你不用手写复杂的 Builder 模式，也不用暴露多个构造器，一个注解搞定一切。更厉害的是，它还支持用 @DefaultFactory 注解引用静态方法作为动态默认值来源。比如默认用户名可以从系统属性读取，或者默认时间戳用当前时间——这种灵活性让 default4j 远不止是“语法糖”，而是真正能融入复杂业务逻辑的工程利器。
第三方类也能“打补丁”，扩展性拉满
很多工具库只支持你自己的类，但 default4j 考虑得更周全。它甚至允许你为外部类（比如 JDK 类或者第三方库的类）添加默认参数支持！只要你在自己的代码里定义一个带 @ExternalDefaults 注解的辅助类，指定目标类和方法签名，就能为那些“不可修改”的类生成默认参数调用。这意味着你可以给 Apache Commons、OkHttp、甚至 Java 标准库的方法“打补丁”，让整个项目的调用风格统一起来。这种能力在大型项目中尤其珍贵——再也不用因为某个工具类没有默认参数而被迫写一堆包装函数了。
为什么选它而不是 Lombok 或 AutoValue？
说到 Java 注解处理器，很多人会想到 Lombok。但 Lombok 功能庞杂，修改字节码的方式也让一些团队望而却步。而 default4j 专注一个点：默认参数。它不碰你的原始类，只生成额外的辅助类，代码完全透明可查。AutoValue 虽然也生成代码，但主要用于不可变对象，不解决方法调用的默认值问题。default4j 则是轻量、精准、无副作用。如果你只是想要默认参数这个功能，引入它比引入整套 Lombok 要干净得多。而且它生成的代码是纯 Java，连反射都不用，连最保守的银行级系统也能放心用。
极简集成，Maven Gradle 一键接入
使用起来也毫无门槛。Maven 用户加个依赖就行：
<dependency> |
Gradle 用户稍微多一行，因为要显式声明注解处理器：
implementation 'io.github.reugn:default4j:最新版本' |
只要你的构建工具支持标准的 Java 注解处理流程（现在基本都支持），开箱即用。IDE 里装个插件或者刷新下项目，就能看到生成的 Defaults 类，自动补全妥妥的。整个过程没有任何魔法，全是标准 Java 生态的常规操作，团队协作时也不会遇到“为什么你本地能跑我这里不行”的玄学问题。
适用场景全覆盖，从工具类到企业级开发
default4j 的适用场景非常广。写工具类时，多参数方法不用再纠结要不要加 Builder；做 API 封装时，客户端调用可以极度简化；在微服务配置中，大量可选参数的初始化变得清晰直观。尤其适合那些需要高可读性和低维护成本的场景。想象一下，以前你需要写五个重载方法来支持不同参数组合，现在一个注解搞定，代码量减少 70%，出错概率直线下降。而且因为是编译期检查，默认值类型不匹配会直接报错，比运行时才发现问题强太多了。对于追求 Clean Code 的团队来说，这简直是生产力核弹。
总结：Java 开发者的默认参数救星
default4j 用最优雅的方式，把现代编程语言的默认参数特性带给了 Java。它不依赖运行时、不修改字节码、不引入复杂概念，只靠编译期代码生成，就让你的 Java 代码变得简洁、可读、易维护。无论是个人项目还是企业级应用，只要受够了方法重载的折磨，它都值得你立刻尝试。在这个 AI 重构开发流程的时代，连 Java 都在悄悄进化——而 default4j，就是你通往更高效 Java 开发的那把钥匙。