Java如何操作properties配置文件实现读写与修改

Java开发中经常需要使用properties配置文件存储数据库连接、应用参数等配置信息，掌握其读写修改操作是开发者的基础技能。properties文件本质是键值对形式的文本文件，Java提供了专门的Properties类来处理这类文件，配合IO流可以完成各类操作需求。

Properties类基础说明

Properties类是Hashtable的子类，专门用于处理属性文件，内置了加载、存储、获取属性等方法，无需开发者手动解析键值对格式。其核心方法包括load(InputStream)加载文件、getProperty(String key)获取属性值、setProperty(String key, String value)设置属性、store(OutputStream, String comments)存储文件等。

读取properties配置文件

读取操作需要先获取文件的输入流，再通过Properties的load方法加载内容，最后通过键获取对应的值。需要注意文件路径的获取方式，避免路径错误导致文件找不到。

import java.io.InputStream;
import java.util.Properties;

public class PropertiesReadDemo {
    public static void main(String[] args) {
        Properties props = new Properties();
        // 通过类加载器获取资源流，文件放在resources目录下
        try (InputStream is = PropertiesReadDemo.class.getClassLoader().getResourceAsStream("config.properties")) {
            if (is == null) {
                System.out.println("未找到配置文件");
                return;
            }
            // 加载配置文件内容
            props.load(is);
            // 获取指定key的属性值，第二个参数为默认值
            String dbUrl = props.getProperty("db.url", "默认数据库地址");
            String dbUser = props.getProperty("db.user", "默认用户名");
            System.out.println("数据库地址：" + dbUrl);
            System.out.println("数据库用户：" + dbUser);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

写入和修改properties配置文件

写入操作需要先加载原有文件内容，修改或新增属性后，再通过输出流将内容写回文件。需要注意store方法会自动添加注释和时间戳，如果要保留原有注释，需要额外的处理逻辑，默认的Properties类不会保留注释信息。

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.Properties;

public class PropertiesWriteDemo {
    public static void main(String[] args) {
        Properties props = new Properties();
        String filePath = "src/main/resources/config.properties";
        try {
            // 先加载原有文件内容，避免覆盖原有配置
            try (InputStream is = new FileInputStream(filePath)) {
                props.load(is);
            }
            // 修改已有配置项
            props.setProperty("db.url", "jdbc:mysql://127.0.0.1:3306/test_db");
            // 新增配置项
            props.setProperty("db.password", "test123456");
            // 将内容写回文件，第二个参数为文件注释
            try (OutputStream os = new FileOutputStream(filePath)) {
                props.store(os, "更新数据库配置信息");
            }
            System.out.println("配置文件更新完成");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

操作注意事项

• 路径问题：使用类加载器获取资源时，文件需要放在项目的resources目录下，如果是绝对路径需要确保路径存在且有读写权限。
• 编码问题：Properties的load方法默认使用ISO-8859-1编码，如果配置文件包含中文，需要在加载时指定UTF-8编码，或者使用InputStreamReader包装输入流。
• 注释保留：默认的Properties类不会保留配置文件中的原有注释，如果有保留注释的需求，可以使用Apache Commons Configuration等第三方工具实现。
• 资源关闭：输入输出流需要手动关闭或者使用try-with-resources语法自动关闭，避免资源泄漏。

常见问题解答

加载文件时报文件找不到错误怎么办

首先检查文件路径是否正确，使用类加载器加载时，确认文件是否在resources目录下，文件名是否和代码中写的一致。如果使用绝对路径，打印路径确认文件是否真实存在。

中文内容出现乱码怎么解决

可以在加载文件时使用InputStreamReader指定编码，示例代码如下：

import java.io.FileInputStream;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
import java.util.Properties;

public class PropertiesCharsetDemo {
    public static void main(String[] args) {
        Properties props = new Properties();
        try (InputStreamReader reader = new InputStreamReader(new FileInputStream("config.properties"), StandardCharsets.UTF_8)) {
            props.load(reader);
            String name = props.getProperty("app.name");
            System.out.println("应用名称：" + name);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Javaproperties配置文件IO流修改时间：2026-06-03 15:09:24