摘要：yaml (YAML Ain’t Markup Language) 是一种人类友好的数据序列化格式。它的可读性很大程度上依赖于缩进规则。 YAML 使用缩进来定义文档的结构和层级关系。 理解 YAML 的缩进规则至关重要，因为错误的缩进会导致 YAML 解析错
yaml (YAML Ain’t Markup Language) 是一种人类友好的数据序列化格式。它的可读性很大程度上依赖于缩进规则。 YAML 使用缩进来定义文档的结构和层级关系。 理解 YAML 的缩进规则至关重要，因为错误的缩进会导致 YAML 解析错误，或者产生与预期不同的数据结构。
以下是 YAML 缩进规则的详细解释：
核心原则：缩进定义结构
缩进是 YAML 中定义层级关系和结构的关键。 它类似于 Python 或其他一些编程语言中代码块的缩进。缩进表示嵌套关系。 更深层次的缩进表示元素是其上方未缩进或缩进较浅的元素的子元素。YAML 依赖于空白字符 (空格) 进行缩进，绝对禁止使用制表符 (Tab) 进行缩进。 这是 YAML 缩进规则中最重要的一点。具体规则:
使用空格进行缩进：YAML 强制使用空格进行缩进。不要使用制表符 (Tab) 字符。 混合使用空格和制表符会导致解析错误。建议使用 2 个空格 作为标准缩进级别，但这并非强制要求，可以使用 2 个、4 个或其他数量的空格，但在一个 YAML 文件中，缩进级别必须保持一致。一致性是关键：在同一个层级下，缩进量必须保持一致。 例如，如果一个层级使用了 2 个空格缩进，那么该层级下的所有子元素都必须使用 2 个空格缩进。不同层级之间的缩进量可以不同，但建议保持一致的增量。 例如，父层级 2 个空格，子层级 4 个空格，孙子层级 6 个空格，以此类推。根级别无缩进：YAML 文档的根级别元素（最顶层）通常不需要缩进。示例说明：让我们通过一些示例来说明 YAML 的缩进规则：示例 1: 简单的键值对yaml复制代码name:JohnDoeage:30city:NewYork在这个例子中，name, age, city 都是根级别的键，它们没有缩进。示例 2: 嵌套结构 (对象)yaml复制代码person:name:JohnDoeage:30address:street:123MainStreetcity:NewYorkperson 是根级别键。name, age, address 是 person 的子键，它们相对于 person 缩进了 2 个空格。street, city 是 address 的子键，它们相对于 address 缩进了 2 个空格 (相对于 person 缩进了 4 个空格)。示例 3: 列表 (数组)yaml复制代码fruits:-apple-banana-orangefruits 是根级别键。- apple, - banana, - orange 是 fruits 的列表项，它们相对于 fruits 缩进了 2 个空格，并且以 - 开头表示列表项。示例 4: 列表和嵌套对象混合yaml复制代码employees:-name:Alicedepartment:Engineeringrole:SoftwareEngineer-name:Bobdepartment:Marketingrole:MarketingManageremployees 是根级别键。- name: Alice ... 和 - name: Bob ... 是 employees 的列表项，每个列表项都是一个对象。name, department, role 是每个列表项对象的键，它们相对于 - 缩进了 2 个空格。错误缩进的例子 (会导致解析错误或结构错误):
混合使用空格和制表符：yaml复制代码# 错误 - 使用了制表符person:name:JohnDoe# 这里使用了制表符缩进不一致 (同一层级)：yaml复制代码# 错误 - age 的缩进不一致person:name:JohnDoeage:30# 这里缩进了 3 个空格，与 name 的 2 个空格不一致缩进不一致 (不同层级，但逻辑错误)：yaml复制代码# 结构错误 - city 应该在 address 下面，但缩进错误导致 city 变成了 person 的直接子键person:name:JohnDoeage:30city:NewYork# 错误地与 person 同级，而不是 address 的子级总结 YAML 缩进规则的关键点:
使用空格进行缩进，禁止使用制表符。缩进量在一个文件中必须保持一致。缩进量表示层级关系，更深的缩进表示嵌套。根级别元素通常无缩进。建议使用 2 个空格作为标准缩进级别。最佳实践:
始终使用空格进行缩进。在一个 YAML 文件中，保持缩进量的一致性。使用文本编辑器或 IDE 的 YAML 语法高亮和格式化功能，帮助检查和维护正确的缩进。使用 YAML 验证工具 (例如在线 YAML 解析器或命令行工具) 验证 YAML 文件的语法和结构。遵循这些缩进规则，你就可以编写出结构清晰、易于阅读和解析的 YAML 文件。 正确的缩进是 YAML 可读性的基石，也是确保 YAML 文件能够被正确解析的关键。
来源：我凯辰韩