java Parameter参数如何命名

在 Java 中，Parameter（方法参数）的命名虽然没有强制语法限制，但遵循一套广泛接受的规范和最佳实践，可以显著提升代码可读性。

一、基本命名规范（必须遵守）

1. 使用驼峰命名法（camelCase）

public void setName(String userName) { }

❌ 错误示例：

public void setName(String user_name) { } // 下划线不符合 Java 规范

2. 见名知意（语义明确）

public void sendEmail(String recipient, String content) { }

❌ 不推荐：

public void sendEmail(String a, String b) { }

3. 避免单字母（除非约定俗成）

• 循环变量：i, j, k
• 数学计算：x, y

for (int i = 0; i < size; i++) { }

普通业务方法不推荐：

public void process(User u) { } // 不推荐

二、常见命名风格与建议

1. 普通参数

public User createUser(String name, int age) { }

2. 布尔类型参数

使用 is / has / can / should 前缀：

public void setVisible(boolean isVisible) { }
public void checkPermission(boolean hasAdmin) { }

3. DTO / 实体参数

直接用类名去掉包名：

public void saveOrder(Order order) { }
public void updateUser(User user) { }

4. 集合参数

使用复数形式：

public void printUsers(List<User> users) { }
public void addRoles(Set<String> roles) { }

5. 回调 / 函数式参数

public void execute(Runnable task) { }
public void handle(Consumer<String> callback) { }

三、与局部变量的区别

参数本身也是局部变量，但命名应更偏向“接口语义”：

// 参数：强调“输入是什么”
public void calculatePrice(BigDecimal basePrice) { }

// 局部变量：强调“计算过程”
BigDecimal discountPrice = basePrice.multiply(0.9);

四、特殊场景命名建议

1. 构造方法参数（防止与字段混淆）

✅ 推荐：

public User(String name, int age) {
    this.name = name;
    this.age = age;
}

或使用 a 前缀（不强制）：

public User(String aName, int aAge) {
    name = aName;
    age = aAge;
}

2. 重写方法参数

保持与原方法一致：

@Override
public boolean equals(Object obj) { }

3. 接口与实现一致

interface UserService {
    void deleteUser(Long userId);
}

五、团队 / 框架常见约定

六、总结一句话

Java 方法参数命名：camelCase + 语义清晰 + 避免缩写 + 与业务一致

如果你有具体代码示例或某个框架场景（如 Spring / MyBatis / Lombok），我可以给出更针对性的命名建议。