如何获取System类中的环境变量和系统属性信息？

本文共计788个文字，预计阅读时间需要4分钟。

Java 中的 System 类是访问运行环境最直接的入口，关键在于其方法 out 用于输出信息。

怎么安全读取操作系统环境变量

用 System.getenv(String name) 直接传变量名，比如 System.getenv("HOME") 或 System.getenv("PATH")。这是推荐做法，性能好且规避了权限问题。

• 别写 System.getenv().get("HOME")：返回的是只读不可变 Map，在 Java 9+ 模块化或 Web 容器中可能触发 SecurityException
• 必须判空：环境变量可能根本没设置，建议用 Objects.requireNonNullElse(System.getenv("TMPDIR"), "/tmp") 提供默认值
• 注意大小写：Linux/macOS 区分大小写（"path" ≠ "PATH"），Windows 不区分，跨平台代码统一用大写键名
• 值是进程启动时的快照：后续系统里改了环境变量，Java 进程不会自动更新

怎么正确获取 JVM 系统属性

System.getProperty(String key) 读的是 JVM 启动时加载的配置，不是操作系统环境变量。常见误区是把 Docker 的 ENV TZ=Asia/Shanghai 当成系统属性去取，结果为 null。

• 内置属性无需设置：如 "os.name"、"java.version"、"user.home"、"file.separator" 都可直接读
• 自定义属性要加 -D 参数：启动命令写 java -Dapp.env=prod MyApp，才能用 System.getProperty("app.env")
• "user.dir" 是当前工作目录，"user.home" 才是用户主目录，别混淆

两个方法不能互相替代的典型场景

判断部署环境时，常需组合使用：

• 查是否在容器中：System.getenv("KUBERNETES_SERVICE_HOST") != null（环境变量）
• 查当前 profile：System.getProperty("spring.profiles.active")（JVM 属性，由 Spring Boot 设置）
• 拼路径时注意分隔符：System.getProperty("user.home") + System.getProperty("file.separator") + "config"
• 读数据库地址：优先从 System.getenv("DB_URL") 获取，未设置再 fallback 到 System.getProperty("db.url")

额外提醒：别误用 setProperty 和 getenv

System.setProperty() 只影响当前 JVM 内部，不影响操作系统；System.getenv() 无法通过 Java 代码修改系统环境变量——它只是只读快照。

• 不要试图用 System.setProperty("PATH", "...") 去改系统 PATH，无效
• 需要动态变更环境变量的场景（如热加载配置路径），得靠外部机制（如监听文件、调用脚本）配合
• 敏感变量（如密码）不建议塞进环境变量再用 getenv 读，应走更安全的凭据管理方案