包和导入

源文件可以以包声明开头：

package org.example

fun printMessage() { /*...*/ }
class Message { /*...*/ }

// ...

源文件的所有内容，如类和函数，都包含在此包中。因此，在上面的示例中，printMessage() 的完整名称是 org.example.printMessage，Message 的完整名称是 org.example.Message。

如果未指定包，则此类文件的内容属于没有名称的 默认 包。

默认导入

一些包默认导入到每个 Kotlin 文件中：

• kotlin.*
• kotlin.annotation.*
• kotlin.collections.*
• kotlin.comparisons.*
• kotlin.io.*
• kotlin.ranges.*
• kotlin.sequences.*
• kotlin.text.*

根据目标平台，还会导入额外的包：

• JVM:

  • java.lang.*
  • kotlin.jvm.*

• JS:

  • kotlin.js.*

导入

除了默认导入之外，每个文件还可以包含自己的 import 指令。

你可以导入单个名称：

import org.example.Message // Message 现在无需限定即可访问

或者导入某个作用域的所有可访问内容：包、类、对象等：

import org.example.* // 'org.example' 中的所有内容都变得可访问

如果存在名称冲突，你可以使用 as 关键字局部重命名冲突实体以消除歧义：

import org.example.Message // Message 可访问
import org.test.Message as TestMessage // TestMessage 代表 'org.test.Message'

import 关键字不限于导入类；你也可以用它来导入其他声明：

• 顶层函数和属性
• 在对象声明中声明的函数和属性
• 枚举常量

顶层声明的可见性

如果一个顶层声明被标记为 private，则它对其声明所在的文件私有（参见可见性修饰符）。