app.name=Hello World
app.version=1.0

Main.java 代码：

package com.example;
import java.io.InputStream;
import java.util.Properties;
public class Main {
    public static void main(String[] args) {
        // 1. 创建 Properties 对象
        Properties props = new Properties();
        // try-with-resources 语句，可以自动关闭流
        try (InputStream input = Main.class.getClassLoader().getResourceAsStream("config.properties")) {
            // 2. 检查流是否成功加载
            if (input == null) {
                System.out.println("Sorry, unable to find config.properties");
                return;
            }
            // 3. 加载属性文件
            props.load(input);
            // 4. 获取属性值
            String appName = props.getProperty("app.name");
            String appVersion = props.getProperty("app.version");
            // 如果键不存在，可以提供一个默认值
            String author = props.getProperty("author", "Unknown Author");
            System.out.println("Application Name: " + appName);
            System.out.println("Application Version: " + appVersion);
            System.out.println("Author: " + author);
        } catch (Exception ex) {
            ex.printStackTrace();
        }
    }
}

从文件系统加载的示例： 如果你的 config.properties 文件在项目根目录下：

try (FileInputStream input = new FileInputStream("config.properties")) {
    props.load(input);
    // ... 后续操作
} catch (IOException e) {
    e.printStackTrace();
}

使用 java.lang.System 类

这种方法适用于将配置信息作为环境变量或 JVM 启动参数传递给应用程序。

作为环境变量设置

在操作系统级别设置环境变量（在 Linux/macOS 中：export APP_NAME=MyApp），然后在 Java 代码中通过 System.getenv() 获取。

String appName = System.getenv("APP_NAME"); // 获取环境变量
System.out.println("App Name from Env: " + appName);

作为 JVM 启动参数设置

在运行 Java 程序时，使用 -D 参数来设置属性。

java -Dapp.name="MyApp" -Dapp.version="2.0" -jar myapp.jar

在 Java 代码中通过 System.getProperty() 获取：

String appName = System.getProperty("app.name"); // 获取JVM属性
String appVersion = System.getProperty("app.version", "1.0"); // 提供默认值
System.out.println("App Name from System Property: " + appName);
System.out.println("App Version from System Property: " + appVersion);

高级用法和最佳实践

处理中文等特殊字符（编码问题）

问题：Properties 文件默认是 ISO-8859-1 编码，直接写入中文会乱码。

解决方案：

• 推荐（Java 9+）：在文件第一行指定编码为 UTF-8。

  # -*- coding: UTF-8 -*-
  app.message=你好，世界！

  这样 Properties.load() 方法会自动使用正确的编码。

• 传统（Java 8及以下）：如果无法修改文件，可以在 Java 代码中进行手动转义。

  • 写入时：将字符串转换为 Unicode 转义序列。

    String chinese = "你好";
    String unicodeEscape = NativeToAsciiUtils.nativeToAscii(chinese); // 需要工具类
    props.setProperty("app.message", unicodeEscape);

  • 读取时：Properties 类会自动将 \uXXXX 转换回字符。

写入 Properties 文件

除了读取,你还可以修改 Properties 对象并将其写回文件。

import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Properties;
public class WritePropertiesExample {
    public static void main(String[] args) {
        Properties props = new Properties();
        // 设置一些属性
        props.setProperty("database.url", "jdbc:mysql://newhost:3306/newdb");
        props.setProperty("user", "admin");
        props.setProperty("password", "newpassword123");
        // 写入文件
        try (FileOutputStream output = new FileOutputStream("config.properties")) {
            // 可以添加一个注释头
            props.store(output, "This is an updated configuration file");
            System.out.println("Properties file updated successfully!");
        } catch (IOException io) {
            io.printStackTrace();
        }
    }
}

store 方法的第二个参数是注释，它会作为文件的第一行（以 开头）。

资源管理

最佳实践：始终使用 try-with-resources。

InputStream 和 OutputStream 都是需要手动关闭的资源，使用 try-with-resources 语句可以确保它们在使用后被自动关闭，即使发生异常也不会导致资源泄漏。

// 推荐
try (InputStream input = ...) {
    // ...
} // input 自动关闭
// 不推荐（旧式）
InputStream input = null;
try {
    input = ...
    // ...
} finally {
    if (input != null) {
        try {
            input.close();
        } catch (IOException e) {
            // ...
        }
    }
}

核心建议：

1. 将配置与代码分离：将 properties 文件放在 resources 目录下，而不是硬编码在 Java 文件中。
2. 优先从类路径加载：使用 ClassLoader.getResourceAsStream()，这能保证你的应用在打包成 JAR 或 WAR 后仍然能正常读取配置。
3. 使用 try-with-resources：确保所有 InputStream 和 OutputStream 都被正确关闭。
4. 处理编码：如果是 Java 9+，在文件开头声明 UTF-8 编码，如果是旧版本，考虑使用工具类或确保编辑器以 ISO-8859-1 格式保存。
5. 提供默认值：使用 getProperty(key, defaultValue) 方法，增强程序的健壮性，避免因某个配置项缺失而崩溃。