@AllArgsConstructor

[🎁 1. 核心作用：自动生成全参构造函数](#🎁 1. 核心作用：自动生成全参构造函数)
- [❌ 手动编写（繁琐）：](#❌ 手动编写（繁琐）：)
- [✅ 使用注解（简洁）：](#✅ 使用注解（简洁）：)
[⚙️ 2. 常用参数配置](#⚙️ 2. 常用参数配置)
[🚀 3. 主要使用场景](#🚀 3. 主要使用场景)
[⚠️ 4. 注意事项与坑](#⚠️ 4. 注意事项与坑)
[📌 总结](#📌 总结)

@AllArgsConstructor 是 Java 开发中非常流行的一个注解，它属于 Lombok 库。
简单来说，它的作用是"偷懒神器"------帮你自动生成一个包含类中所有字段的构造函数，让你不需要手动编写那些冗长且重复的代码。

🎁 1. 核心作用：自动生成全参构造函数

当你在一个类上使用 @AllArgsConstructor 注解时，Lombok 会在编译时自动为你生成一个构造方法。这个构造方法包含该类所有字段作为参数，并在方法体内将这些参数赋值给对应的成员变量。

对比一下使用前后的代码变化，你就明白了：

❌ 手动编写（繁琐）：

java 复制代码

public class User {
    private String name;
    private int age;
    private String email;

    // 手动写的全参构造函数，代码很长
    public User(String name, int age, String email) {
        this.name = name;
        this.age = age;
        this.email = email;
    }
}

✅ 使用注解（简洁）：

java 复制代码

import lombok.AllArgsConstructor;

@AllArgsConstructor
public class User {
    private String name;
    private int age;
    private String email;
    
    // Lombok 会自动帮你生成全参构造函数，代码干干净净
}

⚙️ 2. 常用参数配置

@AllArgsConstructor 不只是简单的生成代码，你还可以通过参数来控制它的行为。

参数名	作用	常用取值	说明
`access`	设置构造函数的访问权限	`AccessLevel.PUBLIC` (默认) `AccessLevel.PRIVATE` `AccessLevel.PROTECTED`	控制生成的构造函数是公有的、私有的还是受保护的。
`staticName`	生成静态工厂方法	例如 `"of"` 或 `"create"`	如果设置了这个值，Lombok 会生成一个静态方法来创建对象，而不是直接生成构造函数。

举个例子：

如果你写 @AllArgsConstructor(staticName = "of")，那么你可以用 User.of("张三", 25, "xxx@xx.com") 来创建对象，而不是用 new User(...)。

🚀 3. 主要使用场景

这个注解在实际开发中非常有用，特别是在以下几种情况：

不可变对象（Value Objects）：当你希望对象一旦创建就不能修改（通常配合 final 字段使用）时，全参构造函数是初始化它们的最佳方式。

依赖注入（Spring Boot）：在 Spring 框架中，推荐使用构造函数注入（Constructor Injection）来保证 Bean 的不可变性和完整性。使用这个注解可以避免写大量的 @Autowired 或构造函数代码。

单元测试：在写测试用例时，经常需要快速构建包含特定数据的对象，全参构造函数非常方便。

DTO/Entity 类：数据传输对象通常需要灵活的初始化方式。

⚠️ 4. 注意事项与坑

虽然它很好用，但在使用时也要注意以下几点：

参数顺序问题：生成的构造函数参数顺序是严格按照类中字段定义的顺序来的。如果你调整了字段顺序，调用该构造函数的地方可能会出现传参错位的逻辑错误（虽然编译不会报错）。

配合继承：如果你的类有父类，@AllArgsConstructor 生成的构造函数不会自动调用父类的构造函数。如果父类没有无参构造函数，你可能需要手动编写构造函数来处理 super(...)。

与 @Builder、@NoArgsConstructor 的关系：

在实际项目中，我们经常看到这三个注解一起使用。

@NoArgsConstructor：生成无参构造函数（通常用于 JSON 反序列化或 JPA 实体）。

@Builder：生成建造者模式的方法（用于链式调用，参数多时可读性好）。

@AllArgsConstructor：生成全参构造函数。

📌 总结

@AllArgsConstructor 是一个能显著提升开发效率的工具，它通过消除样板代码（Boilerplate Code）让 Java 代码看起来更现代、更简洁。建议你在构建数据类、配置类或需要强依赖注入的类时大胆使用它。