Kotlin 命令行编译器

Kotlin 的每个版本都附带一个独立的编译器。你可以手动下载最新版本或通过包管理器下载。

安装命令行编译器并非使用 Kotlin 的必要步骤。 常见的方法是使用支持 Kotlin 的官方 IDE 或代码编辑器来编写 Kotlin 应用程序， 例如 IntelliJ IDEA 或 Android Studio。 它们提供开箱即用的完整 Kotlin 支持。

了解如何在 IDE 中开始使用 Kotlin。

安装编译器

手动安装

要手动安装 Kotlin 编译器：

1. 从 GitHub Releases 下载最新版本（kotlin-compiler-2.2.10.zip）。
2. 将独立编译器解压到某个目录中，并可选地将 bin 目录添加到系统路径。bin 目录包含在 Windows、macOS 和 Linux 上编译和运行 Kotlin 所需的脚本。

如果你想在 Windows 上使用 Kotlin 命令行编译器，我们建议手动安装它。

SDKMAN!

在基于 UNIX 的系统（例如 macOS、Linux、Cygwin、FreeBSD 和 Solaris）上安装 Kotlin 更简单的方法是 SDKMAN!。它也适用于 Bash 和 ZSH shell。了解如何 安装 SDKMAN!。

要通过 SDKMAN! 安装 Kotlin 编译器，请在终端中运行以下命令：

sdk install kotlin

Homebrew

或者，在 macOS 上你可以通过 Homebrew 安装编译器：

brew update
brew install kotlin

Snap 包

如果你在 Ubuntu 16.04 或更高版本上使用 Snap，可以通过命令行安装编译器：

sudo snap install --classic kotlin

创建并运行应用程序

1. 在 Kotlin 中创建一个简单的控制台 JVM 应用程序，显示“Hello, World!”。在代码编辑器中，创建一个名为 hello.kt 的新文件，其中包含以下代码：

   fun main() {
       println("Hello, World!")
   }

2. 使用 Kotlin 编译器编译应用程序：

   kotlinc hello.kt -include-runtime -d hello.jar

   • -d 选项指示生成的类文件的输出路径，该路径可以是目录或 .jar 文件。
   • -include-runtime 选项通过在生成的 .jar 文件中包含 Kotlin 运行时库，使其成为自包含的可运行文件。

   要查看所有可用选项，请运行：

   kotlinc -help

3. 运行应用程序：

   java -jar hello.jar

要编译 Kotlin/Native 应用程序，请使用 Kotlin/Native 编译器。

编译库

如果你正在开发一个供其他 Kotlin 应用程序使用的库，可以在不包含 Kotlin 运行时的情况下构建 .jar 文件：

kotlinc hello.kt -d hello.jar

由于以这种方式编译的二进制文件依赖于 Kotlin 运行时，因此每当你的编译库被使用时，都应确保它存在于 classpath 中。

你也可以使用 kotlin 脚本来运行由 Kotlin 编译器生成的二进制文件：

kotlin -classpath hello.jar HelloKt

HelloKt 是 Kotlin 编译器为名为 hello.kt 的文件生成的主类名。

要编译 Kotlin/Native 库，请使用 Kotlin/Native 编译器。

运行 REPL

使用 -Xrepl 编译器选项 运行编译器以获得交互式 shell。在此 shell 中，你可以输入任何有效的 Kotlin 代码并查看结果。

运行脚本

你可以将 Kotlin 用作脚本语言。Kotlin 脚本是包含顶层可执行代码的 Kotlin 源文件（.kts）。

import java.io.File

// 获取传入的路径，即 “-d some/path” 或使用当前路径。
val path = if (args.contains("-d")) args[1 + args.indexOf("-d")]
           else "."

val folders = File(path).listFiles { file -> file.isDirectory() }
folders?.forEach { folder -> println(folder) }

要运行脚本，请将 -script 选项与相应的脚本文件一起传递给编译器：

kotlinc -script list_folders.kts -- -d <path_to_folder_to_inspect>

Kotlin 为脚本自定义提供实验性的支持，例如添加外部属性、提供静态或动态依赖项等等。自定义由所谓的 脚本定义 定义——即带有相应支持代码的、带有注解的 Kotlin 类。脚本文件扩展名用于选择相应的定义。了解更多关于 Kotlin 自定义脚本 的信息。

当相应的 jar 文件包含在编译 classpath 中时，准备好的脚本定义会被自动检测并应用。或者，你可以通过向编译器传递 -script-templates 选项来手动指定定义：

kotlinc -script-templates org.example.CustomScriptDefinition -script custom.script1.kts

有关更多详细信息，请参见 KEEP-75。