跳到主要内容

Kotlin 环境配置

在开始编写 Kotlin 代码之前，我们需要先配置好开发环境。本章将介绍如何安装 Kotlin 编译器、配置 IDE，以及创建和运行第一个 Kotlin 程序。

Kotlin 运行环境​

Kotlin 程序可以在多种环境中运行：

  1. JVM：最常用的方式，需要安装 JDK
  2. Kotlin/JS：编译为 JavaScript，用于 Web 开发
  3. Kotlin/Native：编译为原生二进制，不需要 JVM

对于初学者，我们推荐使用 JVM 方式。

安装 JDK​

Kotlin 运行在 JVM 上，所以首先需要安装 Java Development Kit（JDK）。

检查是否已安装 JDK​

在终端或命令行中输入以下命令检查：

# 检查 Java 版本
java -version

# 检查 JDK 是否已配置
javac -version

如果显示版本信息，说明已经安装了 JDK。建议使用 JDK 17 或更高版本。

安装 JDK​

Windows​

  1. 下载 JDK 17+（推荐 Eclipse Temurin）
  2. 运行安装程序，按照提示完成安装
  3. 配置环境变量：
    • 右键"此电脑" → "属性" → "高级系统设置"
    • 点击"环境变量"
    • 在系统变量中新建：
      • 变量名：JAVA_HOME
      • 变量值：C:\Program Files\Java\jdk-17（你的安装路径）
    • 编辑 Path 变量，添加：%JAVA_HOME%\bin

macOS​

使用 Homebrew 安装：

# 安装 Homebrew（如果没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 JDK
brew install openjdk@17

# 配置环境变量
echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux​

# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-17-jdk

# CentOS/RHEL
sudo yum install java-17-openjdk-devel

安装 Kotlin 编译器​

方式一：使用 IDE（推荐）​

对于初学者，推荐使用 IntelliJ IDEA 或 Android Studio：

  1. 下载 IntelliJ IDEA Community（免费版）
  2. 安装并启动
  3. 创建新项目时选择 Kotlin 作为语言

IDE 会自动处理 Kotlin 编译器的安装和配置。

方式二：手动安装 Kotlin 编译器​

如果你只想使用命令行，可以手动安装 Kotlin 编译器：

Windows​

  1. 下载 Kotlin 编译器
  2. 解压到合适的位置（如 C:\kotlin）
  3. 添加到 PATH 环境变量：
    • 编辑系统变量 Path
    • 添加：C:\kotlin\bin

macOS / Linux​

# 使用 Homebrew 安装
brew install kotlin

# 或者下载手动安装
curl -s https://get.sdkman.io | bash
sdk install kotlin

验证安装​

# 检查 Kotlin 编译器版本
kotlinc -version

# 检查 Kotlin 运行时版本
kotlin -version

使用命令行运行 Kotlin​

方式一：使用 kotlinc 编译​

# 1. 创建源文件
mkdir hello-kotlin
cd hello-kotlin
echo 'fun main() = println("Hello, Kotlin!")' > Hello.kt

# 2. 编译
kotlinc Hello.kt -include-runtime -d Hello.jar

# 3. 运行
java -jar Hello.jar

参数说明：

  • kotlinc：Kotlin 编译器
  • -include-runtime：将 Kotlin 运行时打包进 JAR
  • -d Hello.jar：指定输出文件名

方式二：使用 kotlin 脚本模式​

Kotlin 也可以作为脚本语言使用：

# 直接运行 .kts 脚本文件
kotlin script.kts

或者使用交互式 REPL：

# 启动 Kotlin REPL
kotlin

# 在 REPL 中输入代码
>>> val x = 10
>>> println(x * 2)
20

使用 IntelliJ IDEA​

IntelliJ IDEA 是 JetBrains 出品的 IDE，对 Kotlin 支持最好。

创建第一个 Kotlin 项目​

  1. 启动 IntelliJ IDEA
  2. 点击 "Create New Project"
  3. 选择左侧 "Kotlin" → "JVM"
  4. 设置项目名称和位置
  5. 点击 "Finish"

项目结构​

my-project/
├── src/
│   └── main/
│       └── kotlin/
│           └── Main.kt      # 源代码
├── out/                     # 编译输出
├── build.gradle.kts        # 构建配置
└── settings.gradle.kts     # 项目设置

运行程序​

  1. 在代码编辑区域右键
  2. 选择 "Run 'MainKt'"
  3. 可以在底部 "Run" 窗口查看输出

使用 VS Code​

如果你更喜欢轻量级的编辑器，可以使用 VS Code：

  1. 安装 VS Code
  2. 安装 Kotlin 语言插件：
    • 打开 Extensions（Ctrl+Shift+X）
    • 搜索 "Kotlin" 并安装
  3. 安装 Kotlin 编译器（如前所述）

使用在线环境​

如果你只是想快速尝试 Kotlin，可以使用在线环境：

  1. Kotlin Playground - 官方在线编辑器
  2. JDoodle
  3. Replit

第一个 Kotlin 程序​

让我们创建经典的 "Hello, World!" 程序：

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

代码解释​

  • fun main()：定义主函数，程序入口
  • println()：打印一行文本并换行
  • {}：函数体用大括号包裹

运行结果​

Hello, World!

尝试修改​

尝试修改程序，打印更多信息：

fun main() {
    val name = "Kotlin"
    val version = 1.9
    
    println("Hello, $name!")
    println("Version: $version")
    
    // 使用模板表达式进行计算
    println("2 + 3 = ${2 + 3}")
}

运行结果：

Hello, Kotlin!
Version: 1.9
2 + 3 = 5

Gradle 构建工具​

对于实际项目，推荐使用 Gradle 进行构建管理。

安装 Gradle​

# macOS
brew install gradle

# Windows（使用 SDKMAN）
sdk install gradle

# 验证安装
gradle --version

创建 Gradle 项目​

# 创建项目目录
mkdir hello-gradle
cd hello-gradle

# 生成项目结构
gradle wrapper --gradle-version 8.5

# 添加 Kotlin 支持

build.gradle.kts 示例​

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

application {
    mainClass.set("MainKt")
}

repositories {
    mavenCentral()
}

dependencies {
    // 添加依赖
}

配置国内镜像​

在国内访问 Maven 仓库可能较慢，可以配置国内镜像：

修改 build.gradle.kts​

repositories {
    maven { url = uri("https://maven.aliyun.com/repository/public/") }
    maven { url = uri("https://maven.aliyun.com/repository/central/") }
    mavenCentral()
}

小结​

本章我们学习了：

  1. JDK 安装：Kotlin 运行在 JVM 上，需要安装 JDK
  2. Kotlin 编译器：可以通过 IDE 或手动安装
  3. 运行方式：命令行、IDE、在线环境
  4. 第一个程序：创建并运行 Hello World
  5. Gradle：项目构建工具

练习​

  1. 在你的电脑上安装 JDK 和 Kotlin 编译器
  2. 使用命令行编译并运行 Hello World 程序
  3. 安装 IntelliJ IDEA 并创建第一个 Kotlin 项目
  4. 修改程序，打印你的名字和年龄