4. YANG 数据建模语言：基础语法、模块结构与数据类型

YANG（Yet Another Next Generation）是 IETF 标准化的数据建模语言（RFC 7950），用于定义网络设备配置数据、状态数据、远程过程调用（RPC）和通知的结构与约束。在控制平面接口调用与基线核验自动化中，YANG 是 NETCONF/RESTCONF 操作的核心契约，理解其语法与结构是编写自动化脚本、解析设备能力与生成基线模板的前提。

4.1 YANG 模块结构

一个 YANG 模块由头部声明、导入/包含语句、正文定义三部分组成。模块是 YANG 数据模型的基本容器，通常对应一个功能领域（如接口、路由、ACL）。

module example-interface {
    namespace "http://example.com/ns/interface";
    prefix if;

    import ietf-yang-types { prefix yang; }

    container interfaces {
        list interface {
            key "name";
            leaf name { type string; }
            leaf type { type enumeration { enum ethernet; enum loopback; } }
            leaf enabled { type boolean; default true; }
        }
    }
}

4.2 YANG 基础语法

YANG 语法采用类似 C 风格的花括号块结构，语句以分号结尾。核心语法规则包括：

• 关键字与标识符：关键字小写（如 container、leaf、list）；自定义标识符可包含字母、数字、连字符、下划线，不能以数字开头。
• 语句结构：keyword [argument] { substatements; }，其中 argument 可以是字符串、数字或引用。
• 注释：支持单行 // 和多行 /* ... */ 注释。
• 引用与路径：使用 prefix:node-name 格式引用外部模块节点；../ 表示父级路径。
• 必须声明：mandatory true; 强制节点在配置中必须存在。
• 默认值：default <value>; 为 leaf 指定默认值。

4.3 数据类型系统

YANG 提供丰富的内置数据类型，并支持通过 typedef 自定义派生类型。数据类型决定了节点可接受的值范围与格式。

typedef ipv4-address {
    type string {
        pattern '[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}';
    }
    description "IPv4 地址格式";
}

typedef admin-status {
    type enumeration {
        enum up;
        enum down;
        enum testing;
    }
    default up;
}

4.4 容器（Container）与列表（List）

容器和列表是 YANG 中组织数据层次的核心结构。容器用于将相关叶子节点分组，列表用于表示可重复的条目集合。

4.5 基线核验中的 YANG 应用

在自动化基线核验场景中，YANG 模型用于：

• 定义期望基线：将设备配置的期望值建模为 YANG 容器/列表结构，存储为 JSON/XML 模板。
• 解析设备状态：通过 NETCONF <get> 或 RESTCONF GET 获取设备实际运行数据，YANG 模型提供解析路径。
• 差异对比：将实际数据与基线模板按 YANG 结构逐节点对比，自动标记偏离项。
• 约束校验：利用 YANG 的 must、when、range 等约束语句，在数据写入前验证合规性。