当前位置：首页 > news >正文

yaml学习笔记

news 2026/5/17 14:32:00

文章目录

yaml语言学习
- yaml 简介
- yaml 和json 区别
- 基本语法
- 数据类型
- - YAML 对象
  - YAML 数组
  - 锚点和引用
  - 纯量
- 参考文档

yaml语言学习

最近发现在学习k8s中各种配置文件都是使用的yaml 这种格式, 包括 docker-compose.yaml 也都是用这个格式配置部署项目信息,我就了解了一下这个语法就有了这篇文章.

yaml 简介

YAML 是 “YAML Ain’t a Markup Language”（YAML 不是一种标记语言）的递归缩写。,它是一种高可读的数据序列号语言, 可以被绝大数编程语言支持使用, 主要用于数据序列号,配置文件等.

在开发的这种语言时，YAML 的意思其实是：“Yet Another Markup Language”（仍是一种标记语言）。

数据序列化就是可以高效的表示或描述数据以及数据关系的,以便用于储存和传输.

优点:

语法简单
结构清晰,易于阅读
功能丰富,可以描述比JSON更加复杂的结构

yaml 和json 区别

yaml 中可以添加注释的.json 是不支持添加注释
yaml 中有锚点和引用的概念, 而json 中没有.

基本语法

大小写敏感
使用缩进表示层级关系, 缩进必须是空格
缩进的空格数不重要，只要相同层级的元素左对齐即可
# 表示注释

缩进数量不重要, 一般设为2个,或者4个都可以. 只是表示层级关系.

app:name: erverydayserver: host: bb.comport: 3338ip: 11.11.22.33

{"app": {"name": "erveryday","server": {"host": "bb.com","port": 3338,"ip": "11.11.22.33"}}
}

spring:datasource:driveClassName: com.mysql.jdbc.Driverurl: aabb.comusername: testpassword: xxxxxx-xxx-xxxtype: com.alibaba.Database

转换后JSON

{"spring": {"datasource": {"driveClassName": "com.mysql.jdbc.Driver","url": "aabb.com","username": "test","password": "xxxxxx-xxx-xxx"}},"type": "com.alibaba.Database"
}

数据类型

YAML 支持以下几种数据类型：

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

YAML 对象

对象键值对使用冒号结构表示 key: value，注意: 冒号后面要加一个空格。

也可以使用 key:{key1: value1, key2: value2, …}。

对象中也是可以嵌套对象的.

app: erveryday
server:host: bb.comport: 3338ip: 11.11.22.33

对应的json 文件如下:

{"app": "erveryday","server": {"host": "bb.com","port": 3338,"ip": "11.11.22.33"}
}

YAML 数组

以 - 开头的行表示构成一个数组：

注意 - 后面有一个空格

- A
- B
- Cpersons:- frank- xiaoming- zhangsan

fruits:- apple- orange- banana- pear

转换为JSON对应

{"fruits": ["apple","orange","banana","pear"]
}

锚点和引用

定义锚点可以使用锚点的数据

& 用来建立锚点（defaults），<< 表示合并到当前数据，* 用来引用锚点。

spring:datasource:dev:driveClassName: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306username: devpassword: xxxxxx-xxx-xxxtype: com.alibaba.Databasetest:driveClassName: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306username: testpassword: xxxxxx-xxx-xxxtype: com.alibaba.Databaseprod:driveClassName: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://aaa.bbb.com:3306username: prodpassword: xxxxxx-xxx-xxxtype: com.alibaba.Database

比如上面 driveClassName 都是一样的, 我需要写三遍, 这个时候可以使用锚点来解决这个问题.

定义一个& + ClassName 作为一个锚点, 引用的时候使用 *ClassName 来引用锚点的值, 其中 ClassName 就是锚点名称.

spring:datasource:dev:driveClassName: &ClassName com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306username: devpassword: xxxxxx-xxx-xxxtype: com.alibaba.Databasetest:driveClassName: *ClassNameurl: jdbc:mysql://localhost:3306username: testpassword: xxxxxx-xxx-xxxtype: com.alibaba.Databaseprod:driveClassName: *ClassNameurl: jdbc:mysql://aaa.bbb.com:3306username: prodpassword: xxxxxx-xxx-xxxtype: com.alibaba.Database

第二种方式引用, 定义个默认配置信息, &default 这是一个锚点,然后需要吧这个信息放到下面的配置段中, 同时我不希望有key 值, 可以使用 << 表示连接引用, 后面使用 *default 即可.

# 定义 default 锚点
defaults: &defaultsdriver: mysqlhost:   localhostdev:database: devdefault: *defaultstest:database: test<<: *defaultsprod:database: prod<<: *defaults

{"defaults": {"driver": "mysql","host": "localhost"},"dev": {"database": "dev","driver": "mysql","host": "localhost"},"test": {"database": "test","driver": "mysql","host": "localhost"},"prod": {"database": "prod","driver": "mysql","host": "localhost"}
}

纯量

纯量是最基本的，不可再分的值，包括：

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

boolean: - TRUE  #true,True都可以 - FALSE  #false，False都可以
float:- 3.14- 6.8523015e+5  #可以使用科学计数法
int:- 123- 0b1010_0111_0100_1010_1110    #二进制表示
null:nodeName: 'node'parent: ~  #使用~表示null
string:- 哈哈- 'Hello world'  #可以使用双引号或者单引号包裹特殊字符- newlinenewline2    #字符串可以拆成多行，每一行会被转化成一个空格
date:- 2018-02-17    #日期必须使用ISO 8601格式，即yyyy-MM-dd
datetime: -  2018-02-17T15:02:31+08:00    #时间使用ISO 8601格式，时间和日期之间使用T连接，最后使用+代表时区

参考文档

在线验证工具 https://www.bejson.com/validators/yaml_editor/
转化工具jsontoyaml https://www.bejson.com/json/json2yaml/
https://zhuanlan.zhihu.com/p/644393484
https://blog.csdn.net/weixin_44896406/article/details/120916357
菜鸟教程 https://www.runoob.com/w3cnote/yaml-intro.html
yaml 引用语法 https://curder.github.io/yaml-study/guide/quote.html

分享快乐,留住感动. '2024-01-25 20:27:31' --frank