

YAML（发音为 /ˈjæməl/，全称 **YAML Ain’t Markup Language**）是一种轻量级、以数据为中心的序列化语言，广泛用于配置文件、数据交换和自动化脚本中。相比 XML 和 JSON，YAML 的最大优势在于其**高度可读性**和**简洁的语法**，被开发者亲切地称为“为人类编写的数据格式”。

---

## 1. YAML 的核心设计理念

YAML 的诞生并非为了取代 JSON 或 XML，而是为了解决它们在**可读性**和**易用性**上的不足。其设计目标明确而实用：

- ✅ **易于人类阅读和编写**  
- ✅ **支持跨语言的数据交换**  
- ✅ **天然适配脚本语言和配置场景**  
- ✅ **表达能力强，支持复杂数据结构**  
- ✅ **语法简洁，学习成本低**

这些特性使 YAML 成为 DevOps 工具链（如 Docker Compose、Kubernetes、Ansible 等）中的首选配置语言。

---

## 2. YAML 与 JSON、XML 的对比

| 特性 | XML | JSON | YAML |
|------|-----|------|------|
| 可读性 | 较差（标签冗余） | 中等（需引号、括号） | **优秀（接近自然语言）** |
| 语法复杂度 | 高 | 中 | **低** |
| 数据表达能力 | 强（支持注释、命名空间） | 有限（仅支持基本类型） | **更强（支持锚点、多文档、复杂键等）** |
| 与编程语言兼容性 | 一般 | 极佳 | **极佳（JSON 是 YAML 的子集）** |

> 💡 **关键点**：所有合法的 JSON 文件都是有效的 YAML 文件，但反之不成立。YAML 在保持 JSON 兼容性的同时，提供了更丰富的语法糖。

例如，在 YAML 中，字符串通常**不需要引号**，列表和映射也无需花括号或方括号（除非内联使用）：

```yaml
# YAML 写法（简洁）
name: Alice
hobbies:
  - reading
  - coding

# 等价 JSON（需更多符号）
{
  "name": "Alice",
  "hobbies": ["reading", "coding"]
}
```

此外，YAML 还支持**锚点引用（Anchor & Alias）**，可高效复用重复数据，这是 JSON 无法实现的。

---

## 3. YAML 文档结构

![文档示图](https://developer.qcloudimg.com/http-save/yehe-100000/9a85994f8146d460c33b3b468dd3e287.png)
一个 YAML 文件可以包含**一个或多个独立文档**，文档之间用 `---` 分隔，可选使用 `...` 表示结束（常用于流式传输）：

```yaml
---
# 第一个文档
title: Introduction

---
# 第二个文档
author: John Doe
...
```

> 📌 **提示**：单文档 YAML 可省略 `---`；`...` 在大多数本地配置场景中非必需。

YAML 的数据模型基于三种基本结构：

1. **标量（Scalar）**：如字符串、数字、布尔值、日期等。
2. **序列（Sequence）**：有序列表，类似数组。
3. **映射（Mapping）**：键值对集合，类似字典或对象。

这三种结构可任意嵌套，构建出复杂的层次化数据。

---

## 4. YAML 编写规范详解

### 基础语法规则

- **大小写敏感**
- **缩进表示层级**（必须使用空格，禁用 Tab）
- **同级元素左对齐即可**，缩进数量无硬性要求（但建议统一，如 2 空格）

### 规范一：编码与注释

- 文件应使用 **UTF-8** 编码。
- 使用 `#` 添加注释：

```yaml
# 用户配置
user:
  name: Tom   # 用户名
  age: 30
```

### 规范二：序列表示

- 使用 `- `（短横 + 空格）表示列表项：
  ```yaml
  fruits:
    - apple
    - banana
  ```
- 内联列表使用 `[ ]`：
  ```yaml
  colors: [red, green, blue]
  ```

### 规范三：映射（键值对）

- 标准形式：`key: value`（冒号后需空格）
  ```yaml
  database:
    host: localhost
    port: 5432
  ```
- 内联映射使用 `{ }`：
  ```yaml
  metadata: {version: 1.0, author: "Jane"}
  ```

> ⚠️ 当键本身是复杂结构（如列表或映射）时，需用 `?` 显式声明：
> ```yaml
> ? [x, y, z]
> : coordinates
> ```

### 规范四：多行文本处理

YAML 提供三种多行字符串写法：

| 符号 | 行为 | 示例 |
|------|------|------|
| `|` | 保留换行（块字面量） | `text: \|<br>  Line 1<br>  Line 2` → 保留两行 |
| `>` | 折叠换行为空格（块折叠） | `text: \><br>  Line 1<br>  Line 2` → 合并为一行 |
| `"..."` 或 `'...'` | 普通字符串（支持转义） | `"Line 1\nLine 2"` |

### 规范五：数据类型与类型提示

YAML 能自动推断常见类型（整数、浮点、布尔、null、时间等），也可通过 `!!` 显式指定：

```yaml
# 自动推断
age: 25
price: 99.99
active: true
created_at: 2025-04-01

# 强制类型（避免歧义）
date_as_string: !!str 2025-04-01  # 确保是字符串而非日期
binary_data: !!binary |
  R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5OTk6enp56enmleECcgggoBADs=
```

内置类型包括：`!!int`, `!!float`, `!!bool`, `!!str`, `!!timestamp`, `!!null`, `!!seq`, `!!map` 等。

### 规范六：锚点与引用（高效复用数据）

通过 `&` 定义锚点，`*` 引用，避免重复：

```yaml
defaults: &defaults
  timeout: 30
  retries: 3

service_a:
  <<: *defaults
  name: api

service_b:
  <<: *defaults
  name: db
```

> 🔗 此功能在 Kubernetes 或 CI/CD 配置中极为实用，可大幅减少冗余代码。

---

## 5. 小结

YAML 凭借其**简洁、清晰、强大**的特性，已成为现代软件开发中不可或缺的数据格式。它既适合人类编写，又便于机器解析，尤其在配置管理、自动化部署等领域大放异彩。

> 📘 **官方规范参考**：[YAML 1.2 Specification](http://www.yaml.org/spec/1.2/spec.html)

掌握 YAML，不仅是提升开发效率的关键一步，更是融入云原生生态的基础技能。

--- 

如需进一步精简、扩展某一部分，或转换为教程/幻灯片风格，也可以告诉我！

YAML（发音为 /ˈjæməl/，全称 YAML Ain’t Markup Language）是一种轻量级、以数据为中心的序列化语言，广泛用于配置文件、数据交换和自动化脚本中。相比 XML 和 JSON，YAML 的最大优势在于其高度可读性和简洁的语法，被开发者亲切地称为“为人类编写的数据格式”。

万字详文深入理解 YAML：YAML是什么|YAML有什么用|一种为人类设计的数据格式

编程语言

开发工具

后端

YAML是一种轻量级数据序列化语言，以高可读性和简洁语法著称，被广泛应用于配置文件和数据交换。相比JSON和XML，YAML支持更复杂的数据结构、多文档格式和锚点引用，同时保持与JSON的兼容性。作为DevOps工具链的首选配置语言，YAML在Docker、Kubernetes等场景中发挥重要作用。

软件开发

数据结构

Kubernetes

云原生

DevOps

JSON

2026采购季 | AI焕新·智启新局

coding

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

万字详文深入理解 YAML：YAML是什么|YAML有什么用|一种为人类设计的数据格式-腾讯云开发者社区-腾讯云

万字详文深入理解 YAML：YAML是什么|YAML有什么用|一种为人类设计的数据格式

万字详文深入理解 YAML：YAML是什么|YAML有什么用|一种为人类设计的数据格式

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐