Kotlin中import语句如何定位目标文件路径？

Kotlin编译器并不依赖文件系统路径来关联包名，它通过以下核心逻辑找到导入的实体：

• 扫描全部源码目录：编译器会遍历你配置的所有源码根目录（如src/main/kotlin），读取目录下所有Kotlin文件，不管这些文件处于哪个子路径。
• 构建包-实体映射表：每读取一个文件，就提取其顶部声明的package语句，将文件内的类、函数、属性等实体与该包名绑定，存入内部符号表。比如一个存于src/animals/kittens的文件，只要声明了package animals.mammals.cats，其内部所有实体都会被归类到animals.mammals.cats包下。
• 解析导入时匹配符号表：当遇到import animals.mammals.cats.*这类导入语句时，编译器直接查询内部符号表中animals.mammals.cats包对应的所有实体，完全不需要关心这些实体的源文件实际存储路径。

举个直观的例子：

1. 源文件src/foo/bar.kt的顶部声明为：

package com.example.utils

fun printHello() { println("Hello") }

2. 另一个文件中写入：

import com.example.utils.*

fun main() {
    printHello() // 编译器能正常找到该函数
}

编译器扫描到src/foo/bar.kt后，会把printHello()注册到com.example.utils包的条目下，解析导入时直接从该条目匹配调用的函数。

注：虽然Kotlin支持包名与路径分离，但建议保持包名和文件路径一致，这能让项目结构更直观，降低团队协作成本，也是行业通用的编码习惯。

内容的提问来源于stack exchange，提问作者Alessandro De Simone