Kotlin 中读取环境变量 | Baeldung中文网

1. 概述

在本教程中，我们将介绍如何在 Kotlin 中读取操作系统中的环境变量。

对于有经验的开发者来说，这可能是一个相对基础的问题，但实际开发中仍有一些细节需要注意，尤其是在跨平台兼容性和空值处理方面。本文将从实际使用出发，结合示例代码说明如何正确获取环境变量。

在 Kotlin 中，我们可以通过调用 System.getenv(String) 方法来读取环境变量。这与我们在 Java 中的做法是一致的。

要获取特定名称的环境变量，可以使用如下代码：

val homeDir = System.getenv("HOME")
assertNotNull(homeDir)

这段代码会获取名为 HOME 的环境变量。如果该变量存在，将返回其值；否则返回 null。因此，在使用前建议进行空值判断，避免空指针异常。

⚠️ 踩坑提醒： 环境变量名称是大小写敏感的，尤其在 Linux 和 macOS 系统上，务必确保名称完全匹配。

当我们尝试获取一个不存在的环境变量时，方法会返回 null，例如：

assertNull(System.getenv("INVALID_ENV_NAME"))

这个特性可以帮助我们判断环境变量是否存在，也可以用于配置的可选参数处理。

如果不传参数调用 getenv()，则会返回系统中所有的环境变量，类型为 Map<String, String>：

val allEnv = System.getenv()
allEnv.forEach { (key, value) ->
    println("$key => $value")
}
assertThat(allEnv).isNotEmpty()

输出示例：

KUBECONFIG => /Users/Ali/.kube/config
LC_TERMINAL => iTerm2
DEFAULT_USER => Ali
// 其他变量略

✅ 建议： 如果你需要调试当前运行环境的变量，打印全部环境变量是一个快速有效的方式。

在 Kotlin 中读取环境变量与 Java 几乎完全一致，使用的是 System.getenv() 相关 API。

虽然语法上是 Kotlin 的写法，但底层依赖的依旧是 JVM 的机制，因此行为与 Java 完全一致。

完整示例代码可在 GitHub 上查看。