SkillPedia Skills Encyclopedia
中文 EN
今日更新 2026-11-17 UTC

今天还没有新提交

查看更新动态

开发与工程 · 进阶

YAML(配置文件格式)

YAML Ain't Markup Language

一种专门写配置文件的文本格式,靠缩进和冒号表达层次。读起来接近一份清单,但缩进本身就是语法,对不齐就读不懂。

开发与工程 进阶 站内文案里出现过 7 次,涉及 3 个条目 473 字 约 1 分钟读完 46 次阅读

TL;DR三十秒版本

  1. 一种专门写配置文件的文字格式,靠缩进和冒号表示上下层关系。
  2. 它读起来像一份清爽的清单,不用写一堆括号和引号。
  3. 缩进本身就是语法,多一个或少一个空格都可能整份读不懂。

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你可能还会看到这些写法

YML YAML 配置

这些都是同一个概念,在技能介绍里指代的是同一件事 —— 不必因为写法不同而以为是两个东西。

全站第 86 / 186 条 · 全部词条

接着读Related reading

接着去哪Explore more

回到技能本身

词典里讲到的这些概念,大多一条命令就能装进你的 AI 客户端。