在服务器上安装 Kotlin 并运行第一个程序：零基础命令实操

Kotlin 本身是运行在 JVM 上的语言，服务器上装 Kotlin 通常指两件事：装 JDK，再装 Kotlin 编译器 kotlinc。
两者都准备好后，就能用命令行编译 .kt 文件并运行。
本文以常见的 Linux 服务器（Ubuntu/Debian 或 CentOS 系）为例，给出可直接照做的步骤，以及出错时的排查方向。

先确认服务器环境

开始前先确认三件事：系统版本、是否已装 Java、是否有下载和解压权限。

• 查看系统版本：cat /etc/os-release
• 查看 Java 版本：java -version
• 查看当前用户是否有 sudo 权限：sudo -v

Kotlin 命令行工具需要 JDK 才能运行，建议使用 JDK 8 或更高版本。
如果 java -version 报 command not found，先装 JDK。
在 Ubuntu/Debian 上可执行：

sudo apt update
sudo apt install -y default-jdk

在 CentOS/RHEL 系上可执行：

sudo yum install -y java-17-openjdk-devel

装完再执行 java -version，能看到版本号即说明 JDK 就绪。

两种安装 Kotlin 的方式

方式一：用 SDKMAN 安装（推荐新手）

SDKMAN 是管理 JVM 相关工具版本的脚本工具，安装和切换 Kotlin 版本都方便。

第一步，安装 SDKMAN：

curl -s "https://get.sdkman.io" | bash

第二步，让当前终端加载 SDKMAN：

source "$HOME/.sdkman/bin/sdkman-init.sh"

第三步，安装 Kotlin：

sdk install kotlin

安装过程中会提示是否设为默认版本，按回车确认即可。
完成后验证：

kotlinc -version

能输出类似 info: kotlinc-jvm ... 的版本信息，说明安装成功。

方式二：手动下载编译器压缩包

如果服务器访问 SDKMAN 较慢，或你想固定某个版本，可以手动下载。
先到 Kotlin 官方发布页获取最新编译器压缩包的下载地址，然后在服务器上执行（把链接替换为实际地址）：

cd /opt
sudo curl -L -o kotlin-compiler.zip <编译器压缩包下载地址>
sudo unzip kotlin-compiler.zip

解压后会得到 kotlinc 目录，里面 bin 下就是可执行文件。

配置 PATH 让 kotlinc 全局可用

手动解压方式需要把 bin 目录加入 PATH。
编辑当前用户的配置文件：

nano ~/.bashrc

在文件末尾添加一行（路径按实际解压位置调整）：

export PATH="$PATH:/opt/kotlinc/bin"

保存后让配置生效：

source ~/.bashrc

再次执行 kotlinc -version，能输出信息即配置成功。注意：如果你用的是 zsh，应改 ~/.zshrc，否则新开终端仍会提示找不到命令。

编译并运行第一个 Kotlin 程序

新建一个测试目录和源文件：

mkdir -p ~/kotlin-demo
cd ~/kotlin-demo
nano Hello.kt

写入以下内容：

fun main() {
    println("Hello, Kotlin on server")
}

保存退出后，先编译再运行：

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

预期输出：

Hello, Kotlin on server

-include-runtime 会把 Kotlin 运行时打包进 jar，方便单独运行。
如果你只做编译检查，可以省略该参数，只生成 .class 文件。

常见报错与避坑

• kotlinc: command not found：PATH 没生效。确认改的是当前 shell 对应的配置文件，并重新 source；也可用绝对路径 /opt/kotlinc/bin/kotlinc -version 先验证文件是否存在。
• JAVA_HOME is not set 或找不到 Java：JDK 没装好或环境变量缺失。用 which java 和 java -version 确认，必要时在 ~/.bashrc 中设置 export JAVA_HOME=。
• 下载卡住或超时：服务器到外网不稳定。手动下载方式更适合这种环境，下载后可校验文件完整性再解压。
• 编译很慢：Kotlin 编译器首次启动会初始化，属正常现象；服务器内存过小时可考虑加 swap。
• 权限问题：写 /opt 需要 sudo，普通用户可改解压到 ~/kotlinc 并相应调整 PATH，避免权限混乱。

怎么确认环境真的可用

除了运行 Hello 程序，建议再做两项检查：

1. 执行 kotlinc -version 和 java -version，确认两个命令都能正常输出。
2. 在一个全新的终端会话里再次执行 kotlinc -version，验证 PATH 是永久生效而非只在当前窗口有效。

这两步都通过，说明服务器上的 Kotlin 命令行环境已经可用于后续开发或脚本编译。

关于版本和后续使用

Kotlin 版本更新较快，本文不固定具体版本号，安装时以实际下载或 SDKMAN 提供的版本为准。
如果你后续要在服务器上运行 Gradle 或 Maven 构建的 Kotlin 项目，通常不需要单独装 kotlinc，构建工具会自行管理编译器版本；
只有在需要直接编译单个 .kt 文件时，命令行工具才更直接。

如果编译时报的是源码语法错误而非命令找不到，那属于代码问题，可先核对文件编码是否为 UTF-8、括号是否配对，再逐步缩小范围排查。