设计弃用警告以将列表替换为 vararg

问：

我有以下方法：

fun RowVector(x: Double, y: Double): RowVector2 = RowVector(listOf(x, y)) as RowVector2
fun RowVector(x: Double, y: Double, z: Double): RowVector3 = RowVector(listOf(x, y, z)) as RowVector3
fun RowVector(vararg elements: Double): RowVector = RowVector(elements.asList())

fun RowVector(elements: List<Double>): RowVector = // Actually creates the RowVector instance

虽然有一些合法的用例可以调用，但我想鼓励调用者使用该方法的版本，因为这允许编译器进行一些更智能的类型推断，如下所示：RowVector(elements: List<Double>)vararg

val vector1 = RowVector(listOf(0.0, 1.0, 2.0)) // Type is inferred to be RowVector
val vector2 = RowVector(0.0, 1.0, 2.0) // Compiler can see that only 3 values are passed and therefore infers RowVector3

因此，我添加了一个注释，建议调用者使用该版本，但如果用例实际上是合法的，则很容易被抑制。@DeprecatedRowVector(elements: List<Double>)vararg

我面临的问题是注释部分的设计。我希望IDE替换为，但到目前为止，我还没有找到一种方法来做到这一点：ReplaceWith@DeprecatedRowVector(listOf(0.0, 1.0, 2.0))RowVector(0.0, 1.0, 2.0)

@Deprecated(
    "Prefer the vararg interface if possible as it allows the compiler to infer types better.",
    ReplaceWith("RowVector(*elements.toDoubleArray())")
)

导致 ，这仍然需要手动清理。RowVector(*listOf(0.0, 1.0, 2.0).toDoubleArray())

@Deprecated(
    "Prefer the vararg interface if possible as it allows the compiler to infer types better.",
    ReplaceWith("RowVector(*doubleArrayOf(elements))")
)

奇怪的是什么都不做，而且

@Deprecated(
    "Prefer the vararg interface if possible as it allows the compiler to infer types better.",
    ReplaceWith("RowVector(*elements)")
)

像这样进行字面替换：.RowVector(*listOf(0.0, 1.0, 2.0))

我知道这是第一世界的问题，呼叫者可以很容易地阅读警告并删除警告，但我仍然会尝试让呼叫者尽可能容易。listOf()