使用Kotlin @Deprecated的ReplaceWith注解时能否自动移除旧import

核心结论 #

仅靠@Deprecated搭配ReplaceWith注解，无法实现自动替换时直接移除旧自定义函数导入的效果。
原因是Android Studio（基于IntelliJ平台）的ReplaceWith替换逻辑仅支持自动添加注解中声明的目标导入，没有提供自动删除冲突旧导入的配置能力；当自定义扩展和官方扩展签名完全一致时，同文件存在两个导入必然会出现解析歧义。

可落地的替代解决方案 #

方案1：配合IDE原生导入优化能力处理（零改造成本） #

你当前的注解配置已经是正确的，只需要在团队内约定迁移流程：

• 触发ReplaceWith自动替换后，直接执行IDE的「Optimize Imports」操作（Windows/Linux快捷键Ctrl+Alt+O，macOS快捷键Option+Command+O），IDE会自动识别未被引用的旧自定义扩展导入并删除。
• 批量迁移时可以直接对整个模块/项目执行Code -> Code Cleanup，IDE会自动完成所有报错点的替换+无用导入清理，不需要逐文件手动处理。

方案2：临时修改自定义扩展签名避免冲突（最稳妥，无歧义） #

给废弃的自定义扩展增加一个无感知的默认参数，从根源上消除和官方函数签名完全一致的问题，修改后代码如下：

@Deprecated(
    message = "This is not thread safe. Use the official version from kotlinx.coroutines.flow.update",
    ReplaceWith("update(transformation)", "kotlinx.coroutines.flow.update"),
    DeprecationLevel.ERROR
)
public inline fun <T> MutableStateFlow<T>.update(
    transformation: (previousValue: T) -> T,
    @Suppress("UNUSED_PARAMETER") migrationMarker: Unit = Unit
) {
    value = transformation(value)
}

修改后，所有旧调用点因为只传入了transformation一个参数，会直接优先匹配官方的单参数update函数，不会出现导入解析混淆；等全项目迁移完成后，直接删除这个自定义扩展即可，没有残留兼容问题。

方案3：自定义Lint规则（适合大型团队/多模块项目） #

如果项目体量较大，可以自定义一条Lint检测规则：

• 检测到导入自定义包路径下的MutableStateFlow.update扩展时直接报错
• 提供快速修复能力：自动删除旧导入、添加官方kotlinx.coroutines.flow.update导入
  这种方案迁移一致性最高，但需要额外开发Lint规则，适合百人以上的大型团队使用。

内容的提问来源于stack exchange，提问作者m.reiter