包与导入

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

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，它对于声明它的文件而言是私有的（参见 可见性修饰符）。