Java Properties 配置文件完全指南（从零开始掌握 Java 读取配置文件的正确姿势）

.properties 文件格式

一个典型的 .properties 文件内容如下：

# 数据库配置db.url=jdbc:mysql://localhost:3306/mydbdb.username=rootdb.password=123456# 日志级别log.level=INFO

注意：以 # 开头的是注释；键和值之间用等号 = 或冒号 : 分隔。

如何在 Java 中读取 Properties 文件？

下面是一个完整的示例，展示如何使用 Java 读取 config.properties 文件：

import java.io.InputStream;import java.util.Properties;public class ConfigReader {    public static void main(String[] args) {        // 创建 Properties 对象        Properties prop = new Properties();                try (InputStream input = ConfigReader.class                .getClassLoader()                .getResourceAsStream("config.properties")) {                        // 加载配置文件            prop.load(input);                        // 获取配置项            String dbUrl = prop.getProperty("db.url");            String username = prop.getProperty("db.username");            String password = prop.getProperty("db.password");            String logLevel = prop.getProperty("log.level");                        // 打印配置            System.out.println("数据库地址: " + dbUrl);            System.out.println("用户名: " + username);            System.out.println("日志级别: " + logLevel);                    } catch (Exception e) {            e.printStackTrace();        }    }}

这段代码展示了如何使用 ClassLoader 从类路径下加载 config.properties 文件，并通过 getProperty() 方法获取配置值。

如何写入 Properties 文件？

你也可以动态修改并保存配置到文件中：

import java.io.FileOutputStream;import java.io.IOException;import java.util.Properties;public class ConfigWriter {    public static void main(String[] args) {        Properties prop = new Properties();                // 设置新的属性        prop.setProperty("app.name", "MyJavaApp");        prop.setProperty("version", "1.0.0");                try (FileOutputStream output = new FileOutputStream("app.properties")) {            // 保存到文件，第二个参数是注释            prop.store(output, "Application Configuration");            System.out.println("配置已保存到 app.properties");        } catch (IOException e) {            e.printStackTrace();        }    }}

常见问题与最佳实践

• 文件编码问题：默认情况下，.properties 文件使用 ISO-8859-1 编码。如果包含中文，建议使用 ResourceBundle 或手动指定 UTF-8（Java 9+ 支持）。
• 路径问题：确保配置文件放在 src/main/resources（Maven/Gradle 项目）或类路径下。
• 异常处理：始终使用 try-with-resources 自动关闭流，防止资源泄漏。

总结

通过本教程，你应该已经掌握了 Java Properties 的基本用法，包括如何创建、读取和写入 Properties 配置文件。这种技术广泛应用于各种 Java 项目中，是每个 Java 开发者必须掌握的基础技能。无论你是初学者还是有经验的开发者，合理使用 Java 读取配置文件 的方式都能让你的代码更加清晰、灵活。

希望这篇 Properties 使用教程对你有所帮助！动手试试吧～