原生移动开发 / 系统课时
Kotlin 程序结构
Kotlin 程序结构
本课用一个最小可运行的 Kotlin 文件串起 main 函数、语句、注释、包声明和源文件组织方式。完成后,你能读懂普通 .kt 文件的入口与层次,并分清哪些结构属于语法要求,哪些只是常见工程约定。
学习目标
- 能识别 Kotlin 程序的
main入口以及函数中的执行代码。 - 能正确使用包声明和三种常见注释形式。
- 能读懂
.kt文件中包、导入和顶层声明的组织顺序。
从 main 函数开始执行
普通 Kotlin/JVM 程序可以直接把 main 定义为顶层函数,不需要像 Java 那样先创建一个专门承载入口的类。程序启动后进入 main,函数体中的代码按控制流执行。
下面的文件可以保存为 Main.kt。辅助函数和 main 都是顶层声明,package 指定它们所属的命名空间。
package com.example.basics
// 顶层辅助函数负责生成结果,不依赖额外类实例
fun greeting(name: String): String = "Hello, $name"
// main 是这个示例的程序入口
fun main() {
println(greeting("Kotlin"))
}预期输出
Hello, Kotlin在 IntelliJ IDEA、Android Studio 或 Kotlin 在线运行环境中执行这个 main,都应得到相同文本。具体 IDE 的运行按钮和构建路径可能不同,但入口函数的语义不变。
读懂源文件的组织顺序
一个 .kt 文件通常从 package 开始,随后是需要的 import,最后放类、对象、函数和属性等声明。没有使用外部类型时,import 可以完全省略。
Kotlin 不要求文件名必须与某个类名一致,也允许一个文件中存在多个顶层声明。不过实际项目通常按照主要职责命名文件,例如把应用入口放在 Main.kt,把用户模型放在 User.kt,这样比把大量无关声明堆在同一文件更容易维护。
语句、表达式与分号
函数体中的变量声明、函数调用和赋值等代码构成执行过程。Kotlin 中不少控制结构本身还是表达式,例如 if 可以直接计算并返回一个值,因此不要完全套用 Java 中严格区分“语句”和“表达式”的思路理解 Kotlin。
大多数情况下行尾不需要写分号,换行就足以分隔代码。只有确实需要在同一行书写多个语句时才可能使用 ;。团队代码中通常保持一行一个清晰操作,避免为了缩短代码而主动添加分号。
注释与包声明的边界
单行注释使用 //,普通多行注释使用 /* ... */,面向 API 文档的 KDoc 使用 /** ... */。注释应该解释设计意图、限制条件或不容易从代码直接看出的原因,而不是逐行复述代码做了什么。
package com.example.basics 决定声明的包名,而不是创建目录。Kotlin 编译器并不强制源码目录与包名完全一致,但 Android 和 Gradle 项目通常让目录层级与包名对应,例如 com/example/basics,这样查找源码和维护命名空间都会更直观。
掌握这一结构后,阅读 Kotlin 文件时可以先找包与导入,再识别顶层声明,最后进入具体函数查看执行逻辑;面对 Android 项目中更大的 Activity、ViewModel 或数据类文件时,仍然可以使用同样的阅读顺序。