将一批在服务器端生成的示例人员记录导出为 YAML——一种以空白缩进为语法要素的序列化格式,常用于 Kubernetes 清单、CI 配置和手动编辑的固件数据。与 JSON 不同,YAML 在后续编辑中允许不加引号的标量和注释(生成的转储本身就是一份整洁的映射列表)。
工作原理
peopleToYaml 对人员数组使用 yaml 包的 stringify 函数,生成一系列带有嵌套键的映射,用于结构化字段。空值遵循该库的省略规则。结果是纯文本,你可以将其粘贴到 *.yaml 固件文件中,或使用 yq 进一步转换。
适用场景
- 与 Helm values 或 Compose 文件放在一起的配置风格种子数据
- 当 JSON 括号显得繁琐时,供人工审阅示例记录
- 在 Git 中以可读的按行差异比较人员列表
限制
YAML 的隐式类型推断可能让人意外(其他工具中 no/yes 可能被当作布尔值)——手动编辑时建议加引号。手动编辑后的缩进错误会导致解析失败。输出在转换之前与 JSON 不兼容。批次大小在服务器端受到与生成器子工具相同的限制。
示例
单人记录的转储结果如下:
- firstName: Ada
lastName: Lovelace
gender: F
birthDate: 1815-12-10
email: ada@example.com
添加第二个人会在相同缩进级别追加另一个 - … 列表项。
法律声明
本工具导出的记录属于合成测试数据,并非真实签发的身份信息。请勿将其用于身份验证、KYC(了解你的客户)流程、法律文件或任何需要真实个人数据的场景。