Kotlin 安装与环境配置 #

一、安装方式概述 #

Kotlin 的安装主要有以下几种方式：

方式 适用场景 推荐指数
IntelliJ IDEA 服务端开发、学习 ⭐⭐⭐⭐⭐
Android Studio Android 开发 ⭐⭐⭐⭐⭐
命令行编译器 脚本、CI/CD ⭐⭐⭐
SDKMAN 多版本管理 ⭐⭐⭐⭐

二、使用 IntelliJ IDEA（推荐） #

2.1 下载安装 #

  1. 访问 IntelliJ IDEA 官网
  2. 选择版本：
    • Community（社区版）：免费，适合学习
    • Ultimate（旗舰版）：付费，功能更全
  3. 下载对应系统的安装包
  4. 运行安装程序，按提示完成安装

2.2 创建 Kotlin 项目 #

  1. 打开 IntelliJ IDEA
  2. 点击 “New Project”
  3. 选择 “Kotlin” → “JVM | IDEA”
  4. 配置项目：
    • 项目名称：HelloKotlin
    • 项目位置：选择目录
    • JDK：选择已安装的 JDK（建议 JDK 11+）
  5. 点击 “Create”

2.3 验证安装 #

创建项目后，新建一个 Kotlin 文件：

kotlin 
fun main() {
    println("Hello, Kotlin!")
}

点击运行按钮，如果输出 Hello, Kotlin!，则安装成功。

三、使用 Android Studio #

3.1 下载安装 #

  1. 访问 Android Studio 官网
  2. 下载对应系统的安装包
  3. 运行安装程序
  4. 首次启动会下载 SDK 等组件

3.2 创建 Kotlin 项目 #

  1. 打开 Android Studio
  2. 选择 “New Project”
  3. 选择项目模板（如 “Empty Activity”）
  4. 配置项目：
    • Name：MyApp
    • Package name：com.example.myapp
    • Language：Kotlin（默认）
    • Minimum SDK：选择最低版本
  5. 点击 “Finish”

3.3 Kotlin 插件 #

Android Studio 默认已安装 Kotlin 插件。如需检查：

  1. 打开 Settings/Preferences
  2. 进入 Plugins
  3. 搜索 “Kotlin”
  4. 确保插件已启用

四、命令行安装 #

4.1 macOS #

使用 Homebrew：

bash 
# 安装 Kotlin 编译器
brew install kotlin

# 验证安装
kotlinc -version

使用 SDKMAN：

bash 
# 安装 SDKMAN
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 安装 Kotlin
sdk install kotlin

# 验证安装
kotlin -version

4.2 Linux #

使用 SDKMAN：

bash 
# 安装 SDKMAN
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 安装 Kotlin
sdk install kotlin

手动安装：

bash 
# 下载编译器
wget https://github.com/JetBrains/kotlin/releases/download/v1.9.22/kotlin-compiler-1.9.22.zip

# 解压
unzip kotlin-compiler-1.9.22.zip

# 配置环境变量
export PATH=$PATH:/path/to/kotlinc/bin

# 验证安装
kotlinc -version

4.3 Windows #

使用 Scoop：

powershell 
# 安装 Scoop（如果未安装）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# 安装 Kotlin
scoop install kotlin

# 验证安装
kotlinc -version

使用 Chocolatey：

powershell 
# 安装 Chocolatey（如果未安装）
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# 安装 Kotlin
choco install kotlin

# 验证安装
kotlinc -version

手动安装：

  1. 从 GitHub Releases 下载编译器
  2. 解压到目标目录（如 C:\kotlinc）
  3. 添加环境变量：
    • 打开系统环境变量设置
    • 在 Path 中添加 C:\kotlinc\bin
  4. 打开新的命令行窗口，验证：
    cmd 
    kotlinc -version

五、命令行编译运行 #

5.1 编译 Kotlin 文件 #

创建文件 Hello.kt：

kotlin 
fun main() {
    println("Hello, Kotlin!")
}

编译：

bash 
kotlinc Hello.kt -include-runtime -d Hello.jar

参数说明：

  • -include-runtime：包含 Kotlin 运行时
  • -d Hello.jar：输出 JAR 文件名

5.2 运行程序 #

bash 
java -jar Hello.jar

输出：

text 
Hello, Kotlin!

5.3 交互式 REPL #

Kotlin 提供交互式命令行环境：

bash 
kotlinc

进入 REPL 后：

kotlin 
>>> println("Hello")
Hello
>>> val a = 10
>>> val b = 20
>>> a + b
res2: kotlin.Int = 30
>>> :quit

六、Gradle 项目配置 #

6.1 build.gradle.kts（Kotlin DSL） #

kotlin 
plugins {
    kotlin("jvm") version "1.9.22"
    application
}

group = "com.example"
version = "1.0-SNAPSHOT"

repositories {
    mavenCentral()
}

dependencies {
    implementation(kotlin("stdlib"))
    testImplementation(kotlin("test"))
}

tasks.test {
    useJUnitPlatform()
}

kotlin {
    jvmToolchain(11)
}

application {
    mainClass.set("MainKt")
}

6.2 build.gradle（Groovy DSL） #

groovy 
plugins {
    id 'org.jetbrains.kotlin.jvm' version '1.9.22'
    id 'application'
}

group = 'com.example'
version = '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.jetbrains.kotlin:kotlin-stdlib'
    testImplementation 'org.jetbrains.kotlin:kotlin-test'
}

test {
    useJUnitPlatform()
}

kotlin {
    jvmToolchain(11)
}

application {
    mainClass = 'MainKt'
}

七、Maven 项目配置 #

xml 
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>kotlin-demo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <kotlin.version>1.9.22</kotlin.version>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-stdlib</artifactId>
            <version>${kotlin.version}</version>
        </dependency>
    </dependencies>

    <build>
        <sourceDirectory>src/main/kotlin</sourceDirectory>
        <plugins>
            <plugin>
                <groupId>org.jetbrains.kotlin</groupId>
                <artifactId>kotlin-maven-plugin</artifactId>
                <version>${kotlin.version}</version>
                <executions>
                    <execution>
                        <id>compile</id>
                        <phase>compile</phase>
                        <goals>
                            <goal>compile</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

八、IDE 配置优化 #

8.1 IntelliJ IDEA 推荐设置 #

  1. 代码风格

    • Settings → Editor → Code Style → Kotlin
    • 导入官方代码风格

  2. 插件推荐

    • Kotlin
    • Ktor（服务端开发）
    • Kotlin Serialization

  3. 实时模板

    • Settings → Editor → Live Templates
    • 添加常用代码模板

8.2 常用快捷键 #

功能 Windows/Linux macOS
运行 Shift+F10 Control+R
调试 Shift+F9 Control+D
格式化代码 Ctrl+Alt+L Cmd+Option+L
优化导入 Ctrl+Alt+O Control+Option+O
快速修复 Alt+Enter Option+Enter
查找类 Ctrl+N Cmd+O
查找文件 Ctrl+Shift+N Cmd+Shift+O

九、总结 #

安装 Kotlin 开发环境的步骤：

  1. 选择合适的安装方式
  2. 安装 IDE（推荐 IntelliJ IDEA）
  3. 配置项目构建工具（Gradle/Maven）
  4. 验证安装是否成功

下一步，让我们编写 第一个 Kotlin 程序！

最后更新：2026-03-27