开发与工程 · 进阶
YAML(配置文件格式)
YAML Ain't Markup Language
一种专门写配置文件的文本格式,靠缩进和冒号表达层次。读起来接近一份清单,但缩进本身就是语法,对不齐就读不懂。
TL;DR三十秒版本
- 一种专门写配置文件的文字格式,靠缩进和冒号表示上下层关系。
- 它读起来像一份清爽的清单,不用写一堆括号和引号。
- 缩进本身就是语法,多一个或少一个空格都可能整份读不懂。
Overview详细说说
YAML 是一种专门用来写配置的文本格式。它靠缩进和冒号表达层次结构,读起来像一份条理清楚的清单,不用写一堆括号和引号。常见的软件配置、自动化流程的配置,很多都用它。
它和 JSON 都在表达结构化的数据,区别在风格。JSON 靠大括号和引号,严谨但看着花;YAML 靠缩进,简洁好读但很挑对齐。粗略地说,YAML 更像写给人看的,JSON 更像给机器之间交换用的。同一份配置,两种格式都能表达,选哪个往往看使用场景和团队习惯。
常见的场景:规格说明、技能定义这类文件里,名字、版本、用途这些必备信息,往往就用一小段 YAML 写成。你要自己动手改的时候,最要紧的一条是别动缩进。
缩进就是语法。多一个空格、少一个空格,整份文件就可能读不懂,而屏幕上看不出哪里不一样。用空格比用制表符更保险,一段复制来的文本里悄悄混进制表符,常常就是它报错的原因,肉眼还很难分辨。编辑器通常会自动帮你对齐,但你从网页或聊天里复制配置时,这层保护就没了。
还有个小坑:冒号后面要留一个空格,值才能被正确读到。排查时如果一段配置莫名其妙读不出来,先把可疑的那几行连同前后的缩进一起重新敲一遍,让空格整齐对齐,往往比逐字符去找更快。
Myths常见误解
- ✕以为 YAML 和 JSON 随便用哪个都行 ✓同一份内容两种都能写,选哪个通常看使用场景和团队习惯
- ✕以为多敲一个空格无所谓 ✓缩进就是语法,多一格少一格意思就变了,屏幕上看不出
- ✕以为制表符和空格缩进是一样的 ✓制表符和空格长得像但本质不同,混进来常常就是报错原因
In practice你会在哪用到它
- 照着别人的配置改几个值,特别留意别动原有的缩进
- 配置读不出来时,把可疑的几行连同缩进一起重新敲一遍
- 从网页上复制一段配置后,检查有没有混进制表符
Summary记住这几点就够了
- 专门写配置文件的文本格式,靠缩进和冒号分层
- 读起来接近清单,比 JSON 简洁
- 缩进就是语法,对不齐就会读不懂
- 用空格比用制表符保险
常见问题
YAML(配置文件格式)是什么意思?
一种专门写配置文件的文字格式,靠缩进和冒号表示上下层关系。它读起来像一份清爽的清单,不用写一堆括号和引号。缩进本身就是语法,多一个或少一个空格都可能整份读不懂。
YAML(配置文件格式)一般用在什么地方?
照着别人的配置改几个值,特别留意别动原有的缩进;配置读不出来时,把可疑的几行连同缩进一起重新敲一遍;从网页上复制一段配置后,检查有没有混进制表符。
关于YAML(配置文件格式),最容易搞错的是什么?
以为 YAML 和 JSON 随便用哪个都行,其实同一份内容两种都能写,选哪个通常看使用场景和团队习惯;以为多敲一个空格无所谓,其实缩进就是语法,多一格少一格意思就变了,屏幕上看不出。
YAML(配置文件格式)要记住哪几点?
专门写配置文件的文本格式,靠缩进和冒号分层;读起来接近清单,比 JSON 简洁;缩进就是语法,对不齐就会读不懂;用空格比用制表符保险。
容易踩的坑 从别处复制来的配置可能悄悄混进制表符,肉眼看不出来,却足以让整份文件读不懂。
Also written as你可能还会看到这些写法
这些都是同一个概念,在技能介绍里指代的是同一件事 —— 不必因为写法不同而以为是两个东西。
全站第 86 / 186 条 · 全部词条
接着读Related reading
算法(Algorithm)
算法就是做一件事的固定步骤清单。照着一步步做,同样的输入总能得到同样的结果,电脑就是靠它来完成任务的。
开源(Open Source)
开源就是作者把软件的配方和做法都公开出来,谁都能免费看、免费用,还能改了再分享给别人。
GitHub(代码托管平台)
GitHub 是全球程序员存放和分享代码的网站,既能当作品集,也是大家一起改同一份代码的协作台。
前端(Frontend)
前端是软件里你能看见、能点的那一层。按钮、图片、页面动画,都是它做出来的。
后端(Backend)
后端是软件里用户看不见的那一半。你在界面上点的每一步,背后都由它去查数据、做判断。
自动化(Automation)
自动化就是让电脑按你定好的规则重复做事,把每次都要手动做一遍的活整个交出去。