源文件通常以包声明开头:
package foo.bar fun baz() {} class Goo {} // ……
源文件所有内容(无论是类还是函数)都包含在声明的包内。 所以上例中 baz()
的全名是 <foo.bar.baz、Goo 的全名是 foo.bar.Goo。
如果没有指明包,该文件的内容属于无名字的默认包。
默认导入
有多个包会默认导入到每个 Kotlin 文件中:
- kotlin.*
- kotlin.annotation.*
- kotlin.collections.*
- kotlin.comparisons.* (自 1.1 起)
- kotlin.io.*
- kotlin.ranges.*
- kotlin.sequences.*
- kotlin.text.*
根据目标平台还会导入额外的包:
- JVM:
- java.lang.*
- kotlin.jvm.*
- JS:
导入
除了默认导入之外,每个文件可以包含它自己的导入指令。 导入语法在语法中讲述。
可以导入一个单独的名字,如.
import foo.Bar // 现在 Bar 可以不用限定符访问
也可以导入一个作用域下的所有内容(包、类、对象等):
import foo.* // "foo"中的一切都可访问
如果出现名字冲突,可以使用 as 关键字在本地重命名冲突项来消歧义:
import foo.Bar // Bar 可访问 import bar.Bar as bBar // bBar 代表"bar.Bar"
关键字 import
并不仅限于导入类;也可用它来导入其他声明:
- 顶层函数及属性
- 在对象声明中声明的函数和属性;
- https://www.kotlincn.net/docs/reference/object-dec... href="https://www.kotlincn.net/docs/reference/enum-classes.html">枚举常量
与 Java 不同,Kotlin 没有单独的“import">https://docs.oracle.com/javase/8/docs/technotes/gu... static”语法; 所有这些声明都用 import 关键字导入。
顶层声明的可见性
如果顶层声明是 private 的,它是声明它的文件所私有的(参见 可见性修饰符)。