Spec-Zone.ru › Kotlin 2

Компилятор Kotlin для командной строки

Каждый выпуск Kotlin поставляется с автономной версией компилятора. Вы можете скачать последнюю версию вручную или с помощью менеджера пакетов.

Установка компилятора для командной строки не является обязательным шагом для использования Kotlin. Обычно приложения на Kotlin пишут в IDE или редакторах кода с официальной поддержкой Kotlin, таких как IntelliJ IDEA или Android Studio. В них изначально предусмотрена полная поддержка Kotlin.

Узнайте, как начать работу с Kotlin в IDE.

Установка компилятора

Установка вручную

Чтобы установить компилятор Kotlin вручную:

  1. Скачайте последнюю версию (kotlin-compiler-2.4.20.zip) со страницы выпусков GitHub.

  2. Распакуйте автономный компилятор в каталог и при желании добавьте каталог kotlinc/bin в системную переменную PATH. Каталог bin содержит скрипты, необходимые для компиляции и запуска Kotlin в Windows, macOS и Linux.

Если вы хотите использовать компилятор Kotlin для командной строки в Windows, рекомендуем установить его вручную.

SDKMAN!

Более простой способ установить Kotlin в UNIX-подобных системах, таких как macOS, Linux, Cygwin, FreeBSD и Solaris, — воспользоваться SDKMAN!. Он также работает в оболочках Bash и ZSH. Узнайте, как установить SDKMAN!.

Чтобы установить компилятор Kotlin с помощью SDKMAN!, выполните в терминале следующую команду:

sdk install kotlin

Homebrew

Кроме того, в macOS компилятор можно установить с помощью Homebrew:

brew update
brew install kotlin

Пакет Snap

Если вы используете Snap в Ubuntu 16.04 или более поздней версии, компилятор можно установить из командной строки:

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, можно собрать файл .jar без включения в него библиотеки времени выполнения Kotlin:

kotlinc hello.kt -d hello.jar

Поскольку двоичные файлы, скомпилированные таким образом, зависят от библиотеки времени выполнения Kotlin, убедитесь, что она присутствует в пути к классам при использовании скомпилированной библиотеки.

Для запуска двоичных файлов, созданных компилятором Kotlin, также можно использовать скрипт kotlinr:

kotlinr -classpath hello.jar HelloKt

HelloKt — это имя главного класса, который компилятор Kotlin создаёт для файла с именем hello.kt.

Для компиляции библиотеки Kotlin/Native используйте компилятор Kotlin/Native.

Запуск REPL

Запустите компилятор с параметром -Xrepl, чтобы открыть интерактивную оболочку. В ней можно вводить любой допустимый код Kotlin и просматривать результаты.

Запуск скриптов

Kotlin можно использовать как язык сценариев. Скрипт Kotlin — это исходный файл Kotlin (.kts) с исполняемым кодом верхнего уровня.

import java.io.File

// Get the passed in path, i.e. "-d some/path" or use the current 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-файлы добавлены в путь компиляции. Также можно указать определения вручную, передав компилятору параметр -script-templates:

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

Дополнительные сведения см. в документе KEEP-75.

Что дальше?

Создайте консольное приложение на основе Kotlin/JVM.

14 июля 2026 г.
Руководство по миграции на компилятор K2Создание консольного приложения — руководство

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/command-line.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API