JavaScript / TypeScript 中的 YAML

直接回答

在 JavaScript / TypeScript 中用 js-yaml 等维护中的库加载 YAML,对不可信输入使用安全/类型化 API,并在部署前校验文件。

常用库

js-yaml

示例

npm install js-yaml
import yaml from 'js-yaml';
const doc = yaml.load(text);

常见坑

  • 使用维护中的库(js-yaml)
  • 对不可信输入使用安全/类型化 API
  • 部署前先校验 YAML 语法与结构

相关

校验建议

  • 在 CI 中对样例 YAML 做加载单测。
  • 安全/类型化解析失败应直接拒绝。
  • 歧义标量对照 1.1 与 1.2。
  • 快速检查可用 浏览器校验器。

工程实践

  • 配置与密钥分离:密钥走环境变量或密钥管理,不进仓库明文 YAML。
  • 为关键配置写加载单测,锁定解析库主版本。
  • 对外部输入做大小限制,避免超大 YAML 造成内存压力。
  • 需要注释保留时,评估专用库(如 Python 的 ruamel.yaml)。

下一步

结合 版本差异 与 在线校验,再在 CI 中固定同一解析库版本,避免「本地能过、流水线失败」。