YAML语法介绍

建议PC端访问

https://www.liuluanyi.cn

一、为什么学习它?

在数据格式描述和较复杂数据内容展示方面的配置文件,JSON能够很好的支持,包括语法突出显示、自动格式化、验证工具等。然而缺乏注释,过于严格,长字符串转换会出现问题等等。对于自动化运维人员,面对较复杂的数据结构来说,不得不寻找一个替代的方式。

YAML(YAML 不是标记语言)是一种非常灵活的格式,几乎是 JSON 的超集,已经被用在一些著名的项目中,如 Travis CI、Circle CI 和 AWS CloudFormation。YAML 的库几乎和 JSON 一样无处不在。除了支持注释、换行符分隔、多行字符串、裸字符串和更灵活的类型系统之外,YAML 也支持引用文件,以避免重复代码。

二、简介

YAML 语言(发音 /ˈjæməl/ )的设计目标,就是方便人类读写。它实质上是一种通用的数据串行化格式。

YAML 有一个小的怪癖。所有的 YAML 文件开始行都应该是 ---。这是 YAML 格式的一部分, 表明一个文件的开始。

它的基本语法规则如下。

  • 大小写敏感
  • 使用缩进表示层级关系
  • 缩进时不允许使用Tab键,只允许使用空格。
  • 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
  • # 表示注释,从这个字符一直到行尾,都会被解析器忽略。

YAML 支持的数据结构有三种。

对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary) 数组:一组按次序排列的值,又称为序列(sequence) / 列表(list) 纯量(scalars):单个的、不可再分的值 下面对这三种数据结构做详细介绍:

三、对象

使用冒号代表,格式为key: value。冒号后面要加一个空格:

---
#即表示url属性值;
url: https://www.liuluanyi.cn 

转为 JavaScript 如下:

{ url: 'https://www.liuluanyi.cn'}

Yaml 也允许另一种写法,将所有键值对写成一个行内对象。

--- 
host: { ip: 10.1.1.1, port: 2222 } 

转为 JavaScript 如下:

{ host: { ip: '10.1.1.1', port: 2222 } }

四、数组

列表中的所有成员都开始于相同的缩进级别, 并且使用一个 --- 作为开头(一个横杠和一个空格):

---
ipaddr:
# IP地址列表
- 120.168.117.21
- 120.168.117.22
- 120.168.117.23

转为 JavaScript 如下:

 ipaddr: [ '120.168.117.21', '120.168.117.22', '120.168.117.23' ]

数据结构的子成员是一个数组,则可以在该项下面缩进一个空格。

-
 - source
 - destination
 - services

转为 JavaScript 如下:

[ [ 'source', 'destination', 'services' ] ]

数组也可以采用行内(或者流式)表示法。

services: [FTP, SSH]
companies: [{id: 1,name: company1,price: 200W},{id: 2,name: company2,price: 500W}]

转为 JavaScript 如下:

{ services: [ 'FTP', 'SSH' ] }
{ companies: 
   [ { id: 1, name: 'company1', price: '200W' },
     { id: 2, name: 'company2', price: '500W' } ] }

对象和数组复合使用

languages:
 - Ruby
 - Perl
 - Python 
websites:
 YAML: yaml.org 
 Ruby: ruby-lang.org 
 Python: python.org 

转为 JavaScript 如下:

{ languages: [ 'Ruby', 'Perl', 'Python' ],
  websites: { YAML: 'yaml.org', Ruby: 'ruby-lang.org', Python: 'python.org' } }

常量

  • 字符串
  • 布尔值
  • 整数
  • 浮点数
  • 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'  #可以使用双引号或者单引号包裹特殊字符
    - newline
      newline2    #字符串可以拆成多行,每一行会被转化成一个空格
date:
    - 2018-02-17    #日期必须使用ISO 8601格式,即yyyy-MM-dd
datetime: 
    -  2018-02-17T15:02:31+08:00    #时间使用ISO 8601格式,时间和日期之间使用T连接,最后使用+代表时区

转为 JavaScript 如下:

{ boolean: [ true, false ],
  float: [ 3.14, 685230.15 ],
  int: [ 123, 685230 ],
  null: { nodeName: 'node', parent: null },
  string: [ '哈哈', 'Hello world', 'newline newline2' ],
  date: [ Sat Feb 17 2018 08:00:00 GMT+0800 (中国标准时间) ],
  datetime: [ Sat Feb 17 2018 15:02:31 GMT+0800 (中国标准时间) ] }

特殊符号

1、YAML 允许使用两个感叹号,强制转换数据类型。

e: !!str 123
f: !!str true

转为 JavaScript 如下:

{ e: '123', f: 'true' }

2、 … 和---配合使用,在一个配置文件中代表一个文件的结束:

---
time: 20:03:20
player: Sammy Sosa
action: strike (miss)
...
---
time: 20:03:47
player: Sammy Sosa
action: grand slam
...

3、>在字符串中折叠换行,| 保留换行符,这两个符号是YAML中字符串经常使用的符号,比如:

this: |
  Foo
  Bar
that: >
  Foo
  Bar

转为 JavaScript 如下:

{ this: 'Foo\nBar\n', that: 'Foo Bar\n' }

4、引用。重复的内容在YAML中可以使用&来完成锚点定义,使用*来完成锚点引用,例如:

defaults: &defaults
  adapter:  postgres
  host:     localhost

development:
  database: myapp_development
  <<: *defaults

test:
  database: myapp_test
  <<: *defaults

转为 JavaScript 如下:

{ defaults: { adapter: 'postgres', host: 'localhost' },
  development: 
   { database: 'myapp_development',
     adapter: 'postgres',
     host: 'localhost' },
  test: 
   { database: 'myapp_test',
     adapter: 'postgres',
     host: 'localhost' } }

注意,不能独立的定义锚点,比如不能直接这样写:&SS Sammy Sosa;另外,锚点能够定义更复杂的内容,比如:

default: &default
    - Mark McGwire
    - Sammy Sosa
hr: *default

那么hr相当于引用了default的数组,注意,hr: *default要写在同一行。

本文分享自微信公众号 - 奕知伴解(yzbjchat)

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-07-24

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏玩转JavaEE

终于把Apollo存储加密这件事搞定了 | 本月第二次无套路送书!

一些比较重要的配置信息,比如密码之类的敏感配置,我们希望将配置加密存储,保证安全性。Apollo框架本身没有提供数据加密的功能,如果想要实现数据加密的功能有两种...

11120
来自专栏Python爬虫与数据挖掘

我去面试python岗位了

最近换工作了,坐标上海,裸辞,之前早有前辈们说过,"裸辞一时爽,一直裸辞一直爽",这话一点不假,裸辞你要面临没有收入来源,但是每天眼睁睁看着各种花销不断支出的煎...

59120
来自专栏京程一灯

JavaScript 进阶问题列表[每日前端夜话0x95]

来源:https://github.com/lydiahallie/javascript-questions

11710
来自专栏算法与编程之美

JS|JavaScript脚本也可固定位置

“如果不改变<script>标签的位置,如何固定JS的脚本呢”,当我们在网页中写入JavaScript代码时,如果我们每次都必须在其他标签之后嵌入JavaScr...

15920
来自专栏玩转JavaEE

程序员必备 GitHub 使用技巧

GitHub Pages大家可能都知道,常用的做法,是建立一个gh-pages的分支,通过setting里的设置的GitHub Pages模块可以自动创建该项目...

10020
来自专栏萝卜大杂烩

Python可视化Dash教程简译(一)

“ 作为数据分析的重要一环,把得到的数据或者分析结果以图表的方式展示,是一种直观、优雅的方式。Dash是基于Flask的Python可视化工具,我在学习之余尝试...

1.1K30
来自专栏算法与编程之美

Python|赋值、浅拷贝与深拷贝

在python中一个变量可以说是内存中一个对象的‘标签’或者‘引用’。假设现在有一个变量a。

16520
来自专栏萝卜大杂烩

PKW: asyncio 标准库简介(第 4 期)

”事情很少有根本做不成的;其所以做不成,与其说是条件不够,不如说是由于决心不够。“ ”Few things are impossible in themselv...

7020
来自专栏全栈修炼

ES6 完全使用手册

在我们开发的时候,可能认为应该默认使用 let 而不是 var,这种情况下,对于需要写保护的变量要使用 const。

17230
来自专栏萝卜大杂烩

大神修炼续,为自己搭建一个分布式 IM 系统二【从查找算法聊起】

言归正传,上周更新了 cim 第一版:为自己搭建一个分布式的 IM 系统。没想到反响热烈,最高时上了 GitHubTrendingJava 版块的首位,一天收到...

11020

扫码关注云+社区

领取腾讯云代金券

年度创作总结 领取年终奖励