YAML详解

最新推荐文章于 2026-05-20 11:23:23 发布

原创最新推荐文章于 2026-05-20 11:23:23 发布 · 4.6k 阅读

10 ·

本内容遵循CC 4.0 BY-SA版权协议

Yml 专栏收录该内容

1 篇文章

订阅专栏

本文介绍了YAML，一种简洁且人性化的数据序列化标准，它比XML更简单，且与JSON兼容。内容涵盖YAML的优势，如与XML和JSON的对比，以及详细解释了YAML的文件结构、语法、数据结构和数据类型。此外，文章还探讨了Java中如何操作YAML，包括SnakeYAML、JYaml和YamlBeans库的使用。

介绍

YAML，YAML Ain’t Markup Language的简称。是一种人性化、跨语言的数据序列化标准，基于Unicode的数据序列化语言，围绕敏捷编程语言的常见本地数据类型而设计。它广泛地用于编程需求，从配置文件到Internet消息传递、对象持久性到数据审计。

优势

YAML与XML

具有 XML 同样的优点，但比 XML 更加简单、敏捷等

YAML与JSON

JSON 可以看作是 YAML 的子集，也就是说 JSON 能够做的事情，YAML 也能够做
YAML 能表示得比 JSON 更加简单和阅读，例如“字符串不需要引号”。所以 YAML 容易可以写成 JSON 的格式，但并不建议这种做
YAML 能够描述比 JSON 更加复杂的结构，例如“关系锚点”可以表示数据引用（如重复数据的引用）。

详解

文件结构

YAML文件可以由单个或多个文档组成（文档之间相互独立）。多个文档之间使用“—”（三个横线）作为文档的开始分隔符。使用“…”（三个点）作为文档的结束分隔符（可省略）。单个文档省略分隔符。

语法

缩进：空格
序列：“-”加空格
映射：“:”加空格
注释：“#”

数据结构

对象：键值对的集合，又称为映射（mapping）/ 哈希（hashes） / 字典（dictionary）
数组：一组按次序排列的值，又称为序列（sequence） / 列表（list）
纯量（scalars）：单个的、不可再分的值

数据类型

纯量

整数、浮点、字符串、布尔、Null、时间、日期

# 整数
age: 10
# 浮点
price: 1.48

#  字符串
name: Jane
address: BeiJing

# 布尔
online: true

# Null
car: ~

# 时间（ISO8601 格式）
time: 2019-02-28t21:59:43.10-05:00 

# 日期（iso8601 格式的年、月、日）
date: 2019-02-28

对象

#  对象，即person:{name:Jane, age:20, address:BeiJing}
person: 
    name: Jane
    age: 20
    address: BeiJing

数组

# 数组，即pets:[cat, dog, pig]
pets:
    - cat
    - dog
    - pig

Java操作

数据准备

yml定义

planetName: Earth
continents:
  - name: Asia
    countries:
      - China
      - Japan
      - Korea
  - name: Europe
    countries:
      - England
      - France
      - Germany
  - name: North America
    countries:
      - Ameriac
      - Canada
      - Mexico
  - name: South America
    countries:
      - Brazil
      - Argentina
      - Chile
  - name: Oceania
    countries:
      - Australia
      - New Zealand
  - name: Africa
    countries:
      - Egypt
      - zimbabwe
  - name: Antarctica

Java对象

@Data
public class Earth {
    private String planetName;
    private List<Continent> continents;
}

@Data
public class Continent {
    private String name;
    private List<String> countries;
}

SnakeYAML(推荐)

Maven

<dependency>
    <groupId>org.yaml</groupId>
    <artifactId>snakeyaml</artifactId>
    <version>1.23</version>
</dependency>

示例

public class SnakeYaml {

    public static void main(String[] args) {
        // yml文件转Java对象
        Yaml yaml = new Yaml();
        InputStream input = SnakeYaml.class.getResourceAsStream("/earth.yml");
        Earth earth = yaml.loadAs(input, Earth.class);
        System.out.println(JSON.toJSONString(earth));
    }
}

JYaml

Maven

<dependency>
    <groupId>org.jyaml</groupId>
    <artifactId>jyaml</artifactId>
    <version>1.3</version>
</dependency>

示例

public class JYaml {

    public static void main(String[] args) throws FileNotFoundException {
        // yml文件转Java对象
        InputStream input = SnakeYaml.class.getResourceAsStream("/earth.yml");
        Earth earth = Yaml.loadType(input, Earth.class);
        System.out.println(JSON.toJSONString(earth));
    }
}

YamlBeans

Maven

<dependency>
    <groupId>com.esotericsoftware.yamlbeans</groupId>
    <artifactId>yamlbeans</artifactId>
    <version>1.13</version>
</dependency>

示例

public class YamlBeans {

    public static void main(String[] args) throws Exception {
        // yml文件转Java对象
        FileReader fileReader = new FileReader(new File(YamlBeans.class.getResource("/earth.yml").getPath()));
        YamlReader reader = new YamlReader(fileReader);
        Earth earth = reader.read(Earth.class);
        System.out.println(JSON.toJSONString(earth));

        // Java对象转yml文件
        YamlWriter writer = new YamlWriter(new FileWriter("/Users/liuxiangxiang/Desktop/output.yml"));
        writer.write(earth);
        writer.close();
    }
}