SkillPedia Skills Encyclopedia
中文 EN
Today's updates 2026-11-17 UTC

No new commits yet today

Open the update feed

Development & Engineering · Intermediate

YAML(配置文件格式)

YAML Ain't Markup Language

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

Development & Engineering Intermediate Appears 7 times across the site, in 3 entries 473 characters about 1 min read 47 views

Some fields on this page have no English version yet — they are shown in the original Chinese.

TL;DRIn 30 seconds

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

OverviewIn detail

YAML 是一种专门用来写配置的文本格式。它靠缩进和冒号表达层次结构,读起来像一份条理清楚的清单,不用写一堆括号和引号。常见的软件配置、自动化流程的配置,很多都用它。

它和 JSON 都在表达结构化的数据,区别在风格。JSON 靠大括号和引号,严谨但看着花;YAML 靠缩进,简洁好读但很挑对齐。粗略地说,YAML 更像写给人看的,JSON 更像给机器之间交换用的。同一份配置,两种格式都能表达,选哪个往往看使用场景和团队习惯。

常见的场景:规格说明、技能定义这类文件里,名字、版本、用途这些必备信息,往往就用一小段 YAML 写成。你要自己动手改的时候,最要紧的一条是别动缩进。

缩进就是语法。多一个空格、少一个空格,整份文件就可能读不懂,而屏幕上看不出哪里不一样。用空格比用制表符更保险,一段复制来的文本里悄悄混进制表符,常常就是它报错的原因,肉眼还很难分辨。编辑器通常会自动帮你对齐,但你从网页或聊天里复制配置时,这层保护就没了。

还有个小坑:冒号后面要留一个空格,值才能被正确读到。排查时如果一段配置莫名其妙读不出来,先把可疑的那几行连同前后的缩进一起重新敲一遍,让空格整齐对齐,往往比逐字符去找更快。

MythsCommon misunderstandings

  • 以为 YAML 和 JSON 随便用哪个都行 同一份内容两种都能写,选哪个通常看使用场景和团队习惯
  • 以为多敲一个空格无所谓 缩进就是语法,多一格少一格意思就变了,屏幕上看不出
  • 以为制表符和空格缩进是一样的 制表符和空格长得像但本质不同,混进来常常就是报错原因

In practiceWhere you will meet it

  • 照着别人的配置改几个值,特别留意别动原有的缩进
  • 配置读不出来时,把可疑的几行连同缩进一起重新敲一遍
  • 从网页上复制一段配置后,检查有没有混进制表符

SummaryThe key points

  • 专门写配置文件的文本格式,靠缩进和冒号分层
  • 读起来接近清单,比 JSON 简洁
  • 缩进就是语法,对不齐就会读不懂
  • 用空格比用制表符保险

FAQ

What does YAML(配置文件格式) mean?

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

Where will I run into YAML(配置文件格式)?

照着别人的配置改几个值,特别留意别动原有的缩进;配置读不出来时,把可疑的几行连同缩进一起重新敲一遍;从网页上复制一段配置后,检查有没有混进制表符。

What do people most often get wrong about YAML(配置文件格式)?

以为 YAML 和 JSON 随便用哪个都行 — but 同一份内容两种都能写,选哪个通常看使用场景和团队习惯;以为多敲一个空格无所谓 — but 缩进就是语法,多一格少一格意思就变了,屏幕上看不出。

What are the key points about YAML(配置文件格式)?

专门写配置文件的文本格式,靠缩进和冒号分层;读起来接近清单,比 JSON 简洁;缩进就是语法,对不齐就会读不懂;用空格比用制表符保险。

Common pitfalls 从别处复制来的配置可能悄悄混进制表符,肉眼看不出来,却足以让整份文件读不懂。

Also written asYou may also see it written as

YML YAML 配置

These are all the same concept — the same thing, however it is written in a skill description. Do not mistake different spellings for different ideas.

Entry 86 of 186 · All entries

Keep readingRelated reading

Where to go nextExplore more

Back to the skills themselves

Most of the concepts covered here come from skills that install into your AI client with a single command.