YAML 入门指南：功能、语法与使用方法详解

- 十月 13, 2025

在现代软件开发与运维中，配置文件扮演着至关重要的角色。随着 JSON 和 XML 的广泛应用，另一种更简洁、可读性更强的格式逐渐流行起来——YAML。本文将带你全面了解 YAML 的功能、语法规则以及实际使用方法，帮助你在项目中更高效地管理配置与数据结构。

📘 什么是 YAML？

YAML 是 “YAML Ain’t a Markup Language” 的递归缩写，意为“YAML 不是一种标记语言”。它是一种专注于数据表达的轻量级语言，常用于配置文件、数据序列化、日志结构定义等场景。

YAML 的设计目标是：

可读性强：接近自然语言的结构
语法简洁：避免冗余的标记符号
易于映射：可直接映射为 Python、Ruby、Go 等语言中的数据结构

YAML 被广泛应用于：

DevOps 工具（如 Kubernetes、Ansible）
CI/CD 平台（如 GitHub Actions）
静态网站生成器（如 Jekyll）
各类框架的配置文件（如 Docker Compose）

✏️ 基本语法规则

YAML 的语法非常简洁，但也有一些需要注意的规则：

大小写敏感
使用缩进表示层级关系（只能用空格，不能使用 Tab）
注释使用 # 开头
文件扩展名通常为 .yml 或 .yaml

示例：

# 这是一个 YAML 配置示例
name: He
age: 28
skills:
  - Python
  - DevOps
  - Kubernetes

🧩 支持的数据类型

YAML 支持以下几种基本数据结构：

1. 标量（Scalars）

包括字符串、整数、浮点数、布尔值、Null 等：

title: "YAML 教程"
version: 1.0
active: true
description: null

2. 序列（Sequence）

表示列表，用 - 开头：

languages:
  - Python
  - JavaScript
  - Go

3. 映射（Mapping）

表示键值对结构：

database:
  host: localhost
  port: 3306
  user: root

4. 嵌套结构

可以组合使用序列与映射：

users:
  - name: Alice
    role: admin
  - name: Bob
    role: user

🔁 引用与复用技巧

YAML 支持锚点（Anchor）与引用（Alias），用于复用结构：

defaults: &defaults
  adapter: postgres
  host: localhost

development:
  database: dev_db
  <<: *defaults

production:
  database: prod_db
  <<: *defaults

这可以避免重复定义，提高配置文件的可维护性。

🛠️ 使用场景示例

1. Docker Compose 配置

version: '3'
services:
  web:
    image: nginx
    ports:
      - "80:80"

2. GitHub Actions 工作流

name: CI
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - run: echo "Hello YAML"

3. Kubernetes 部署文件

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
        - name: app
          image: my-app:latest

✅ 总结与建议

YAML 是一种优雅而强大的数据表达语言，尤其适合用于配置和自动化场景。它的语法简洁、结构清晰，能有效提升开发效率与可维护性。

使用建议：

注意缩进规范，避免使用 Tab
合理使用锚点与引用，减少重复
配合 JSON Schema 或 CI 工具进行语法校验
在大型项目中保持结构一致性，便于团队协作

参考资料：

搜索此博客

贺哥笔记