Java 中怎么读取 YAML 格式的本地配置文件-java教程-PHP中文网

java读取本地yaml配置最推荐用snakeyaml库，支持bean绑定和map解析；spring boot项目可直接用@configurationproperties自动绑定，底层仍依赖snakeyaml。

java 中怎么读取 yaml 格式的本地配置文件

Java 读取本地 YAML 配置文件，最常用、最推荐的方式是使用 SnakeYAML 库（轻量、稳定、支持标准 YAML 1.1），配合 Java Bean 或 Map 进行解析。Spring Boot 项目还可直接用 @ConfigurationProperties 自动绑定，但底层仍依赖 SnakeYAML。

添加 SnakeYAML 依赖

如果是 Maven 项目，在 pom.xml 中引入：

<dependency><groupid>org.yaml</groupid><artifactid>snakeyaml</artifactid><version>2.2</version><!-- 推荐使用 2.x 最新版 --></dependency>

Gradle 用户可写：implementation 'org.yaml:snakeyaml:2.2'

用 Yaml.load() 解析为 Java Bean（推荐）

适合结构明确的配置（如 app.yml）：

server:
  port: 8080
  host: localhost
database:
  url: jdbc:h2:mem:testdb
  username: sa

先定义对应 Java 类（注意字段名与 YAML 键名一致，或用 @JsonProperty 映射）：

Java Development Manual

Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载

public class AppConfig {
    private Server server;
    private Database database;
    // getter/setter 省略
}
public class Server {
    private int port;
    private String host;
    // getter/setter
}
public class Database {
    private String url;
    private String username;
    // getter/setter
}

再加载并解析：

InputStream in = getClass().getClassLoader()
    .getResourceAsStream("app.yml"); // 放在 src/main/resources 下
Yaml yaml = new Yaml(new Constructor(AppConfig.class));
AppConfig config = yaml.load(in);

用 Yaml.load() 解析为 Map（灵活但类型不安全）

适合配置结构动态、不确定，或只是临时读取几个字段：

InputStream in = Files.newInputStream(Paths.get("config.yml"));
Yaml yaml = new Yaml();
Map<string object> data = yaml.load(in);
String host = (String) data.get("server").get("host");
int port = (Integer) ((Map) data.get("server")).get("port");</string>

注意：需手动强转，嵌套深时易出 ClassCastException，建议仅用于简单场景或调试。

Spring Boot 中自动绑定（零代码解析）

如果你用 Spring Boot，无需手写解析逻辑：

把 application.yml 放在 src/main/resources
新建配置类，用 @ConfigurationProperties 绑定
确保类被 @EnableConfigurationProperties 或 @Configuration 扫描到

@Component
@ConfigurationProperties(prefix = "server")
public class ServerConfig {
    private int port;
    private String host;
    // getter/setter
}

Spring 启动时会自动从 YAML 加载并注入值，还支持校验（@Validated）、默认值（@DefaultValue）等。