1. 引言
文档的 PDF 版本在 这里。
本文档的代码在 这里。
本文档由 Anthropic 的 AI Claude 生成。它是课程 “通过示例学习 Java 25 语言”(2026 年 10 月)的 Kotlin 移植版,而该课程本身又是课程 “使用 .NET 10 学习 C# 14 语言(2026 年 10 月)的移植版,后者是对 Serge Tahé 于 2008 年 5 月编写的课程 “使用 .NET 3.5 Framework 学习 C# 语言 3.0 版”的重写。它保留了该课程的大纲、示例和主线,并用当今的 Kotlin 重写:
- 本文档使用 Kotlin 2.4 (2.4.20 版,2026 年 9 月),搭配 JDK 25,即 Java 最新的 长期支持(LTS)版本。Kotlin 是一门面向 Java 虚拟机的语言:它生成与 Java 相同的中间代码,并直接使用 Java 的全部库。因此,Java 课程的读者 将看到来自 JDK 的相同的类(文件、网络、线程、日期等)和相同的框架(JUnit、Spring、Jackson、Hibernate、Spring Boot),只是用另一种语言来使用它们;
- 在两种语言不同的地方,本文档所做的不只是翻译。Kotlin 为 Java 以不同方式处理的问题提供了自己的解决方案:内置于类型系统的 空安全 、属性、数据类、扩展函数、运算符重载、函数类型、默认参数值和具名参数,以及 [when] 表达式。反过来,Kotlin 没有 受检异常 或 [static] 成员。这些差异都会详细介绍,通常通过对比 Kotlin 代码与 Java 代码来进行;
- 异步编程一章呈现出不同的特点:Java 使用 [CompletableFuture] 类和虚拟线程,而 Kotlin 提供 协程,以及 [suspend] 函数、[launch] 和 [async] 构造器,以及 结构化并发。这是 Kotlin 对原课程中 C# 的 [async] / [await] 的回答;
- 所用的库是当前在 JVM 上常用的:用于测试的 [JUnit 6] 和 [kotlin.test] ,用于依赖注入的 [Spring Framework 7] ,用于 JSON 的 [Jackson 3] ,用于协程的 [kotlinx.coroutines] ,用于 JDBC 的驱动 [MySQL Connector/J] ,用于对象关系映射的 [Hibernate 7] ,以及用于 Web 服务的 [Spring Boot 4] ;项目使用 [Gradle]构建,其脚本本身就是用 Kotlin 编写的。
本文档不是一门全面的课程。与其所源自的资料一样,它面向已经熟悉编程、希望学习 Kotlin 基础的读者。它采用示例的方式:二百多个程序(三百多个 Kotlin 文件),大多数很短,并带有逐行注释。
1.1. 2011 年至 2026 年的 Kotlin
Kotlin 由 JetBrains公司于 2011 年 7 月推出,该公司是 IDE IntelliJ IDEA 的发行商,当时正在寻找一门比 Java 更简洁、更安全、同时又与之兼容的语言,用来编写自己的工具:Kotlin 程序被编译为 字节码,由 Java 虚拟机 (JVM)执行,既可以调用 Java 代码,也可以被 Java 代码调用。其名称来自芬兰湾中靠近圣彼得堡的一座岛屿,设计它的团队曾在那里工作。
主要里程碑:
- 2016 年:Kotlin 1.0,第一个稳定版本,并附带兼容性承诺;
- 2017 年:Google 宣布官方支持使用 Kotlin 开发 Android 应用;2019 年,Android 变为“Kotlin 优先”:Kotlin 成为新 Android 应用的推荐语言;
- 2018 年:Kotlin 1.3,使 协程趋于稳定,这是 Kotlin 对异步编程的解答(第 9 章);
- 该语言由 JetBrains 开发;Kotlin 基金会由 JetBrains 和 Google 于 2017 年创立,负责监督其演进,每个阶段都要经过公开提案(“KEEP”,Kotlin Evolution and Enhancement Process);
- 2024 年:Kotlin 2.0,带来名为 K2的新编译器,它更快,并且在跟踪代码中的类型(智能类型转换)方面更出色;
- Kotlin 也面向 JVM 以外的平台:JavaScript、WebAssembly 和原生代码(Kotlin/Native,iOS)。本文档只涉及 JVM 上的 Kotlin;
- 自 2.0 版起,大约每六个月发布一个 新的语言版本 (2.1.0、2.2.0、2.3.0、2.4.0……);在两者之间,工具版本 (2.x.20)会在不改变语言的情况下改进工具和标准库。本文档使用 2026 年 9 月发布的 2.4.20 版。新特性通常先作为 实验性特性引入;必须显式启用它们(通过编译器选项或 [@OptIn] 注解),之后才会在后续版本中变得稳定。
下表总结了本文档介绍的语言主要新特性,并指出了它们出现的章节:
版本 | 年份 | 主要新特性 | 章 |
Kotlin 1.0 | 2016 | 空安全、属性、数据类、扩展函数、lambda、[when]、运算符重载 | 3, 4, 7 |
Kotlin 1.1 | 2017 | 类型别名 [typealias]、绑定引用 [object::function]、协程(实验性) | 4, 7 |
Kotlin 1.3 | 2018 | 稳定的协程、[main] 函数可无参数 | 2, 3, 9 |
Kotlin 1.4 | 2020 | 函数式接口 [fun interface]、Kotlin 接口的 SAM 转换 | 7 |
Kotlin 1.5 | 2021 | 无符号类型([UInt]……)和稳定的 [value class] 类、密封接口 | 3, 4 |
Kotlin 1.9 | 2023 | [..<] 运算符、枚举的 [entries] 属性、[data object] | 3, 12 |
Kotlin 2.0 | 2024 | K2 编译器:更精确的智能类型转换 | 4 |
Kotlin 2.2 | 2025 | [when] 中的守卫条件([is Int if x > 0 ->]),带多个 [$] 的插值 | 3, 5 |
Kotlin 2.3 | 2025 | 支持 Java 25 | 2 |
Kotlin 2.4 | 2026 | 在 2.4.20 版中,[kotlinr] 启动器取代了 [kotlin] 命令 | 2 |
在库和工具方面,新特性包括:构建工具 [Gradle] 及其 Kotlin 脚本([build.gradle.kts])、Kotlin 标准库的集合及其高阶函数、序列、协程和流([Flow]),以及在 Kotlin 中使用的主要 Java 生态系统框架:JUnit、Spring、Jackson、Hibernate 和 Spring Boot。
1.2. 文档内容
本文档包括以下章节:
- 第 2 章:搭建开发环境(JDK 25、IntelliJ IDEA、编译器 [kotlinc]、Gradle);
- 第 3 章:语言基础(类型、空安全、运算符、[if] 和 [when]、循环、异常、枚举、函数参数);
- 第 4 章:类、属性、继承、密封类、运算符重载、接口、泛型、数据类、扩展函数;
- 第 5 章:常用的 Kotlin 类:字符串、数组、集合、序列、文本文件和二进制文件、使用 Jackson 处理 JSON、正则表达式;
- 第 6 章:分层架构、使用 JUnit 6 的单元测试,以及使用 Spring 的依赖注入;
- 第 7 章:函数类型、lambda 表达式和事件;
- 第 8 章:执行线程、同步和虚拟线程;
- 第 9 章:使用协程的异步编程;
- 第 10 章:使用 JDBC 访问数据库;
- 第 11 章:Hibernate;
- 第 12 章:Web 编程(TCP/IP、TCP 客户端和服务器、使用 [HttpClient]的 HTTP、SMTP);
- 第 13 章:使用 Spring Boot 的 Web 服务;
- 第 14 章:进一步学习;
- 附录:安装 Laragon 和 MySQL,Gradle 项目使用的依赖。
1.3. 主线:税款计算
本文档反复讨论同一个问题:为只需申报工资的纳税人计算所得税。所用的税率档是最初的版本(2003 年收入):它已不再适用,但对我们的目的来说已经足够,我们的目的是用若干种不同的方式编写同一个应用程序。它分九个版本实现:
版本 | 章 | 内容 |
1 | 3 | 单个程序:经过验证的输入、计算、显示 |
2 | 4 | 类和接口:[TaxBracket], [ITax], [AbstractTax], [HardwiredTax] |
3 | 5 | 从文本文件或 JSON 文件读取计算数据 |
4 | 6 | 一个单程序内的分层架构([dao]、[business]、[ui]) |
5 | 6 | 每层一个 Gradle 子项目、单元测试,以及通过依赖注入集成各层 |
6 | 10 | 一个 [dao] 层,使用 JDBC 从 MySQL 数据库读取数据 |
7 | 11 | 一个 [dao] 层,使用 Hibernate 编写 |
8 | 12 | TCP 税款计算服务器及其客户端 |
9 | 13 | 一个用于税款计算的 REST Web 服务、一个控制台客户端和一个 Web 客户端 |
从第 5 版开始,后续版本 复用 第 5 版的各层,只替换发生变化的那一层:这正是第 6 章介绍的分层架构的全部意义所在。
1.4. 示例
本文档中的代码组织在一个名为 [kotlin-oct-2026]的文件夹中,每章对应一个子文件夹。每个子文件夹都是一个 Gradle 项目(或由多个项目组成的 Gradle 构建),可以直接在 IntelliJ IDEA 中打开:
每个小程序都是一个 Kotlin 文件,存放在以其命名的包中([src/main/kotlin/basics04/Basics04.kt], package [basics04])。你可以在 IntelliJ IDEA 中点击其 [main] 函数旁边的绿色三角形来运行它,也可以通过 Gradle 在命令行中运行([gradlew -q run -Pmain=basics04.Basics04Kt],第 2 章)。需要外部库的程序(Jackson、JUnit、Spring、MySQL 驱动、Hibernate、Spring Boot)必须在项目的 [build.gradle.kts] 文件中声明它:Gradle 会在第一次构建时从 Maven Central 仓库下载它。
本文档中的所有程序都已由 Kotlin 2.4.20 编译器编译,没有错误或警告,编译时使用了将所有警告视为错误的选项([allWarningsAsErrors]),然后在 JDK 25 上运行。本文档中重现的结果就来自这些运行。第 2 章到第 4 章的结果是在法语语言和国家设置(fr-FR)下得到的,就像在法语版 Windows 机器上一样:格式化的浮点数以小数逗号显示,日期也是法语的;后续章节的结果是在英语设置下得到的。两点说明:
- Kotlin 编译器和 JDK 的错误消息(异常消息)是英文的:它们没有法语翻译;
- 示例是在 Linux 上运行的。在大多数情况下这没有区别:JVM 上的 Kotlin 是跨平台的。少数差异(用 / 而不是 \ 的文件路径、终端命令、用 [./gradlew] 代替 [gradlew])会在出现的地方加以说明。
多线程、异步或网络程序的结果,以及测得的时长,可能每次运行都有所不同:注释着重说明可重现的内容。
1.5. 资料来源
本文档的主要资料来源是:
- Kotlin 官方文档:网站 https://kotlinlang.org/docs(语言指南、教程、各版本的“What’s New”页面)以及标准库文档: https://kotlinlang.org/api/core/kotlin-stdlib/;
- 协程指南: https://kotlinlang.org/docs/coroutines-guide.html;
- 语言演进提案(KEEP): https://github.com/Kotlin/KEEP;
- Java 文档,针对 API 和 SE 25,涉及 JDK 中的类: https://docs.oracle.com/en/java/javase/25/;
- Gradle 文档(https://docs.gradle.org)以及各个库的文档:JUnit(https://docs.junit.org)、Spring(https://spring.io/projects)、Hibernate(https://hibernate.org/orm/documentation/)、Jackson(https://github.com/FasterXML/jackson);
- 两本参考书:Sebastian Aigner、Roman Elizarov、Svetlana Isakova 和 Dmitry Jemerov 所著的“Kotlin in Action”(Manning 出版社,第 2 版)和 Marcin Moskała 所著的“Effective Kotlin”;关于线程,Brian Goetz 等人所著的“Java Concurrency in Practice”(Addison-Wesley 出版社)仍然是一本极好的读物。