Android Studio结构搜索可匹配但替换无结果的问题求助

问题背景 #

我在Android项目中遇到KT-73255相关的构建警告，提示数据类参数上的@JsonProperty注解当前仅作用于参数，未来会同时作用于字段，需要添加@field:前缀明确目标。现有大量（约500处）这类代码：

class MyDataClass(
    @JsonProperty("a")
    val aaa: String,

    @JsonProperty("b")
    val bbb: Int,

    @JsonProperty("c")
    val ccc: Int
)

需要批量修改为：

class MyDataClass(
    @field:JsonProperty("a")
    val aaa: String,

    @field:JsonProperty("b")
    val bbb: Int,

    @field:JsonProperty("c")
    val ccc: Int
)

我用Android Studio（Narwhal 3 Feature Drop | 2025.1.3）的结构搜索，使用模板class $Class$(@JsonProperty($Value$)$param$ : $Type$)找到了204个实例，但用替换模板class $Class$(@field:JsonProperty($Value$)$param$ : $Type$)时，IDE提示项目无匹配实例。

问题原因 #

你的结构搜索模板仅匹配单个参数的类，但实际项目中大部分是多参数的数据类。搜索时IDE会把每个单个参数的类实例找出来，但替换时，模板要求整个类的结构完全匹配（只有一个参数），而你的目标类是多参数的，因此无法匹配，导致替换失败。

解决方案 #

方案1：针对参数的结构搜索替换（推荐） #

不要以整个类为搜索对象，而是单独搜索参数上的@JsonProperty注解：

1. 打开结构搜索（Edit > Find > Search Structurally）
2. 在模板语言选择Kotlin，选择Parameter作为上下文
3. 输入搜索模板：

   @JsonProperty($Value$)
   $Param$: $Type$
   

4. 点击"Find"，此时会找到所有参数上的@JsonProperty注解（包括多参数类中的每个参数）
5. 切换到Replace标签，输入替换模板：

   @field:JsonProperty($Value$)
   $Param$: $Type$
   

6. 点击"Replace All"完成批量修改

方案2：正则表达式替换 #

如果结构搜索设置麻烦，也可以用正则批量替换：

1. 打开全局替换（Edit > Find > Replace in Path）
2. 勾选"Regex"选项
3. 搜索框输入：@JsonProperty\("(.*?)"\)
4. 替换框输入：@field:JsonProperty("$1")
5. 限定文件类型为Kotlin（.kt），点击"Replace All"即可

注意：正则替换前建议先预览匹配结果，避免替换到非参数位置的@JsonProperty注解。

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