如何为List参数的RowVector方法设计@Deprecated的ReplaceWith规则

你定义了多个重载的RowVector构造函数，其中接收List<Double>的版本虽有合理使用场景，但你希望优先引导用户使用vararg版本以获得更智能的类型推断。在给该方法添加@Deprecated注解时，发现常规的ReplaceWith配置无法将RowVector(listOf(0.0, 1.0, 2.0))自动替换为RowVector(0.0, 1.0, 2.0)，生成的代码仍带有listOf或spread操作符，需要手动清理。

Kotlin的@ReplaceWith注解仅支持表达式层面的直接替换，无法解析并展开listOf内部的字面量参数。要实现你想要的自动替换效果，需要使用IntelliJ IDEA/Kotlin IDE的**结构化搜索替换（Structural Search and Replace, SSR）**功能，它能识别代码的语法结构并进行精准转换。

具体操作步骤 #

• 打开IDE的结构化替换面板：Edit > Find > Replace Structurally...
• 配置搜索模板：
  1. 在搜索框中输入：RowVector(listOf($elements$))
  2. 点击Edit Variables，设置$elements$的类型为Expression，勾选Allow unlimited repetitions，确保能匹配多个元素的情况
• 配置替换模板：
  在替换框中输入：RowVector($elements$)
• 点击Find预览匹配结果，确认无误后点击Replace All完成批量替换

补充说明 #

• 对于动态生成的List（比如变量引用、计算得到的List），确实无法直接展开为单个参数，此时保留RowVector(*list.toDoubleArray())或手动添加@Suppress("DEPRECATION")即可，这也是你标注Deprecated时预留合理场景的初衷。
• 如果你是库作者，可以在@Deprecated的message中明确告知用户：对于字面量创建的List，使用IDE的结构化替换快速修改；动态List场景可忽略警告。

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