Java方法不能直接返回多个值，必须用容器包装；推荐使用record（Java 14+）或自定义不可变类封装，避免Object[]、数组等类型不安全方案。
Java 方法不能直接返回多个值，必须用容器包装
Java 语言规范决定了 return 只能带一个表达式，所谓“返回多个值”本质是把多个值打包进一个对象里再返回。硬写 return a, b; 会编译失败，报错信息是：error: not a statement。
常见错误是试图用逗号分隔多个值，或误以为类似 Python 的元组解包在 Java 里存在。Java 没有原生多返回值语法，也没隐式元组类型。
- 数组适合同类型、数量固定、临时组合的场景（比如坐标
int[]） - 封装类适合异类型、需语义清晰、可能复用的场景（比如
Result<string integer></string>） - 避免用
Object[]—— 类型不安全，调用方要手动强转，容易出ClassCastException
用自定义类封装多个返回值更安全、可读性更高
比起数组或 List，专门建一个轻量级类（哪怕只有两个字段），能让意图一目了然，且支持 IDE 自动补全和编译期检查。
例如处理用户登录，需要同时返回状态码和用户 ID：
立即学习“Java免费学习笔记（深入）”；
public class LoginResult {
public final int code;
public final long userId;
public LoginResult(int code, long userId) {
this.code = code;
this.userId = userId;
}
}
调用时直接解构字段，不会混淆顺序或类型：
- 字段名自带语义（
codevsuserId），比result[0]和result[1]不易出错 - 如果后续要加第三个字段（如 token），只需改构造函数和类，不影响已有调用逻辑
- 不要用 public 可变字段——万一被外部修改，返回值就不可靠了
用 record 简化封装类（Java 14+）
Java 14 引入的 record 是专为不可变数据载体设计的，一行就能替代十几行样板代码。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
上面的 LoginResult 可简化为：
public record LoginResult(int code, long userId) {}
它自动提供构造方法、equals/hashCode、toString，且所有字段隐式 final。
- record 不能继承、不能有实例初始化块，也不该用于需要行为逻辑的类
- 如果项目还在用 Java 8–13，record 不可用，得退回普通类或考虑
Pair/Triple（但注意 Apache Commons 的Pair是Object类型，泛型擦除后仍有风险） - record 的字段名就是访问名，
result.code()而不是result.getCode()—— 少写括号，但别和普通 getter 混用
数组方案只适合极简、同类型、一次性组合
用 int[] 返回两个整数看似省事，但代价是丢失类型和语义。一旦数组长度变化或元素含义调整，调用方极易出错。
比如这个方法：
public int[] getMinMax(int[] arr) { ... }
调用者必须记住 “索引 0 是 min，索引 1 是 max”，而且无法静态校验是否用了正确的索引。
- 如果返回值中混了
String和boolean，数组根本没法用 —— 只能退到Object[]，失去编译检查 - 数组长度不固定时（比如可能返回 0/1/2 个值），调用方得反复判空和
length，容易漏边界 - 性能上数组确实略快，但除非在高频循环里每微秒都算，否则这点差异远不如可维护性重要
真正需要多值返回的地方，往往不是性能瓶颈，而是协作和演化的成本。选错封装方式，后面修 bug 的时间会远超写几行 record 的时间。
