Kotlin中修改主包后编译失败，为何需重新编译依赖包？

问题根源 #

你遇到的问题是Kotlin编译器的模块管理机制导致的：

• 当你把world和hello包都编译到同一个classes目录时，Kotlin会将它们视为单一模块，并生成对应的模块元数据文件（比如.kotlin_module）。
• 修改hello后单独编译时，kotlinc -d classes -cp classes ...命令会尝试更新这个模块的元数据，但此时编译器无法正确关联原有world包的元数据与新的hello代码，导致符号解析失败——它会认为当前模块里不存在world.foo。

简单说，手动将多个独立包混编到同一个输出目录，会破坏Kotlin的模块边界，让后续单独编译子包时无法识别依赖。

解决办法 #

有几种方式可以避免这个问题：

• 将依赖包编译为独立JAR
  把world编译成JAR文件，作为hello的依赖：

  # 编译world为JAR
  kotlinc -d world.jar src/world/World.kt
  # 编译hello，依赖world.jar
  kotlinc -d classes -cp world.jar src/hello/Main.kt
  # 修改hello后直接重新编译即可
  kotlinc -d classes -cp world.jar src/hello/Main.kt
  

• 使用独立输出目录
  给world和hello分别指定不同的输出目录：

  # 编译world到world_classes
  kotlinc -d world_classes src/world/World.kt
  # 编译hello到classes，依赖world_classes
  kotlinc -d classes -cp world_classes src/hello/Main.kt
  # 修改hello后直接重新编译
  kotlinc -d classes -cp world_classes src/hello/Main.kt
  

• 用构建工具管理项目
  Gradle或Maven这类工具会自动处理模块依赖和增量编译，完全避免手动编译的这类问题，是Kotlin项目的标准做法。

额外说明 #

Kotlin编译器不仅依赖字节码，还需要读取Kotlin特有的元数据（存在.class的@Metadata注解或.kotlin_module文件中）来解析依赖。当多个包共享输出目录时，模块元数据会被反复修改，导致编译器无法正确识别跨包依赖，这就是必须重新编译world才能恢复的核心原因。

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