Kotlin中类的private可见性范围：跨文件定义私有类为何重声明报错

嘿，这个问题我之前也踩过坑！本质是Kotlin的语法规则和JVM底层的访问权限模型没对齐导致的，我给你拆解清楚：

核心原因：Kotlin的private文件级作用域 vs JVM的权限限制 #

• 在Kotlin语言层面，顶级的private类确实是仅在当前文件内可见，这是语言设计的规则。
• 但JVM本身没有“文件级访问权限”的概念，它只支持类级、包级、公有这几类权限。所以Kotlin编译器会把顶级private类编译成**包级私有（package-private）**的字节码类。
• 这就出问题了：如果你的两个文件在同一个包下，编译后的两个Person类在JVM看来是同包下的同名类，JVM不允许同包存在完全同名的类，自然会触发“重声明”冲突。

为什么会出现Cannot access 'Person': it is private in file错误？ #

当编译器检测到同包下有另一个同名的private类时，会陷入混淆：你在Practice1.kt里创建的Person，到底是当前文件的那个，还是另一个文件的？加上底层JVM的同名类冲突，编译器会优先抛出访问权限的错误，本质是重声明冲突引发的上层报错。

解决办法 #

给你几个实用的解决方案：

• 改名处理：最简单直接，给不同文件的类起不同的名字，比如一个叫Practice1Person，另一个叫Practice2Person。
• 调整包结构：把两个文件放到不同的包（哪怕是子包）下，这样JVM层面就不会有同名类的冲突，同时保留private的文件级可见性。
• 嵌套类/对象：把private类嵌套到当前文件的类或对象内部，这样类的全名会带上外层容器的标识，不会和其他文件的类重名。比如：
  Practice1.kt：

  object Practice1Container {
      private class Person(val name: String)
      
      fun createPerson(name: String) = Person(name)
  }
  
  fun main() {
      val smith = Practice1Container.createPerson("Smith") // 完全没问题
  }
  

  Practice2.kt：

  object Practice2Container {
      private class Person(val name: String)
      
      fun createPerson(name: String) = Person(name)
  }
  

• 用internal替代private：如果不需要严格的文件级私有，internal是模块级可见，Kotlin编译器会给编译后的类加上独特的名字修饰，避免同包同名的冲突。

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