KDoc引用init代码块中LongTermStorage出现无法解析符号警告求助

这大概率是Android Studio/IntelliJ IDEA的KDoc解析实现Bug，而非init代码块的KDoc存在特殊限制，原因如下：

1. KDoc规范无限制
   Kotlin官方的KDoc语法规范并没有禁止在init块的文档注释中引用其他类，从语法逻辑上来说，init块的KDoc和类内其他函数、属性的KDoc处于相同的上下文层级，理应支持相同的符号解析能力。

2. IDE解析上下文偏差
   这类报错通常是IDE的KDoc解析器在处理初始化块的注释时，符号解析的上下文环境出现了异常——比如没有正确关联当前类所在的包、导入语句，导致无法识别已导入的LongTermStorage类。

3. 验证方式
   你可以尝试在init块的KDoc中使用LongTermStorage的全限定类名（比如com.yourpackage.storage.LongTermStorage），如果此时警告消失，就完全能确认是IDE的符号解析逻辑问题，而非语法限制。

临时解决办法 #

• 先用全限定类名替代短类名，绕过解析错误；
• 升级Android Studio/IntelliJ到最新稳定版，JetBrains通常会在后续版本修复这类解析类的小Bug；
• 执行File > Invalidate Caches... > Invalidate and Restart，清除IDE缓存后重启，有时候缓存损坏也会导致这类异常。

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