Kotlin是否支持类似Java的包级废弃机制？

好问题！我之前也碰到过一模一样的需求——Kotlin目前并没有提供和Java package-info.java完全对应的包级废弃机制，官方的@Deprecated注解文档确实也没提这块的用法。不过我们可以用一些变通方案来接近这种效果，不用逐个去注解包内的每个类、函数和字段：

1. 用文件级@Deprecated注解标记包 #

在目标包下创建一个专门的顶层文件（比如命名为PackageDeprecation.kt），在文件顶部添加包声明和@Deprecated注解。虽然这个注解本质上是作用于这个文件本身，但它能在IDE中为整个包提供废弃提示，同时可以清晰说明替代方案：

/**
 * @deprecated As of release 2.0, replaced by `com.acme.new.package`
 */
@Deprecated(
    message = "This package is deprecated, please use com.acme.new.package instead",
    replaceWith = ReplaceWith("com.acme.new.package")
)
package com.acme.old.package

2. 结合KDoc补充包级废弃说明 #

如果需要更突出的文档提示，可以在包的KDoc中直接标注废弃信息。同样在包内的任意顶层文件顶部添加：

/**
 * This entire package is deprecated.
 * Use [com.acme.new.package] for all new functionality.
 * @deprecated As of release 2.0, replaced by com.acme.new.package
 */
package com.acme.old.package

这种方式会在IDE的包文档提示中直接显示废弃警告，帮助开发者快速了解包的状态。

需要注意的是，这两种方案都不能像Java的package-info.java那样自动让包内所有元素继承废弃标记，但已经是目前最简便的方式，能大幅减少重复注解的工作量。

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