带固定参数的方法与两种可变参数重载方案的优缺点分析

在设计高性能可变参数方法时，通常会先提供1、2、3个参数的固定重载版本，再搭配以下两种可变参数（vararg）重载方案，各自的优劣势如下：

方案a：末尾带可变参数的重载（如Guava的ImmutableList.of()） #

<T> void consume(T t1, T t2, T t3, T... others)

优势 #

• 减少数组开销：当调用参数超过固定重载的上限（比如3个）时，只有超出部分会被打包进数组，不会把前3个参数也塞进数组，避免了不必要的数组创建和初始化，性能更优。
• 语义清晰：固定参数和可变参数的边界明确，开发者一眼就能看出哪些是方法的核心参数，哪些是额外可选的参数。
• 性能覆盖全面：和前面的固定参数版本配合，小参数数量的调用用固定重载（无数组开销），大参数数量的调用用这个vararg版本，兼顾了性能和灵活性。

劣势 #

• 代码冗余：为了覆盖常用的小参数场景，需要编写多个固定参数的重载方法，代码量增加，后续维护成本更高。
• 扩展性差：如果后续要调整固定参数的数量（比如从3个改成4个），就得修改这个vararg方法的参数列表，可能影响已有调用的兼容性。
• 实现复杂度高：每个重载方法都要单独实现或委托到核心逻辑，逻辑复杂时容易出现实现不一致的问题。

方案b：仅含单个可变参数的重载（如Java 9的List.of()） #

<T> void consume(T... tees)

优势 #

• 代码简洁：只用一个方法就能覆盖所有参数数量的场景，不需要编写多个重载，代码量少，维护起来更省心。
• 扩展性强：不管后续需要支持多少参数数量，都不需要新增方法，只需维护这一个vararg方法即可。
• 逻辑统一：所有超过固定重载上限的调用都会走到同一个方法，逻辑实现一致，不容易出现bug。

劣势 #

• 额外性能开销：当调用参数超过固定重载上限时，所有参数都会被打包进一个新数组，哪怕前几个参数本来可以用固定参数接收，增加了数组创建的开销，性能略逊于方案a。
• 语义模糊：从方法签名无法区分核心参数和额外参数，调用者无法直观感知方法设计的参数优先级。
• 基础类型装箱开销更明显：如果传入基本类型，会自动装箱成包装类型数组，方案b的数组包含所有参数，装箱带来的性能损耗比方案a更突出。

内容的提问来源于stack exchange，提问作者bjmi