YAML转JSON专用工具 - 定向配置转数据格式

文件格式类术语

YAML（YAML Ain't Markup Language）

一种以数据为中心的人类可读数据序列化格式。YAML 使用缩进和换行来表示数据层级关系，语法简洁直观，广泛应用于配置文件、数据交换和日志记录等场景。YAML 文件通常以 .yaml 或 .yml 作为扩展名，与 JSON 相比具有更好的可读性和注释支持。

JSON（JavaScript Object Notation）

一种轻量级的数据交换格式，基于 JavaScript 对象字面量语法。JSON 使用花括号表示对象、方括号表示数组，以键值对形式组织数据。它具有体积小、解析快、语言无关等优点，是 Web API 和配置文件中最常用的数据格式，文件扩展名为 .json。

数据序列化（Data Serialization）

将数据结构或对象状态转换为可存储或可传输格式的过程。序列化使数据能够以标准化的方式在不同系统、语言和平台之间传递。YAML 和 JSON 都是常见的序列化格式，前者侧重可读性，后者侧重传输效率和兼容性。

数据结构类术语

映射（Mapping）

YAML 中表示键值对的数据结构，等同于 JSON 中的对象（Object）。映射使用冒号分隔键和值，键位于冒号前面，值位于冒号后面。多层映射通过缩进来表示嵌套关系。在转换过程中，YAML 映射会被直接映射为 JSON 对象。

序列（Sequence）

YAML 中表示有序列表的数据结构，等同于 JSON 中的数组（Array）。序列中的每个元素以短横线（-）开头，按顺序排列。YAML 也支持内联序列语法，使用方括号和逗号分隔，转换后对应 JSON 数组。

标量（Scalar）

YAML 中的基本数据类型，表示单个值而非复合结构。标量包括字符串、整数、浮点数、布尔值和空值等类型。js-yaml 解析器会根据值的内容自动推断标量类型，转换为对应的 JSON 数据类型（string、number、boolean、null）。

嵌套结构（Nested Structure）

数据元素内部包含其他数据元素的层级组织方式。在 YAML 中通过缩进层级表示，在 JSON 中通过花括号和方括号的嵌套表示。深层嵌套是实际项目中常见的数据模式，本工具支持任意深度的嵌套结构转换。

YAML 高级特性术语

锚点（Anchor）

YAML 中用于定义可复用数据块的标记，语法为 &名称。锚点本身不会产生输出数据，它仅为后续的别名引用提供目标。在 YAML 配置中，锚点可以大幅减少重复代码，提高配置文件的可维护性。转换后，锚点定义处会输出实际数据。

别名（Alias）

YAML 中用于引用锚点定义的数据的标记，语法为 *名称。别名会在解析时被替换为锚点所指向的完整数据。在 JSON 转换中，每个别名引用处都会输出锚点定义的完整数据副本，确保数据的完整性。

合并键（Merge Key）

YAML 中使用 << 符号实现对象合并的特殊语法。合并键可以将一个或多个锚点的键值对合并到当前映射中。如果存在键名冲突，后定义的值会覆盖先前的值。这是 YAML 配置复用的重要机制。

多行字符串（Block Scalar）

YAML 中使用 |（字面量块）或 >（折叠块）表示的多行字符串。字面量块保留所有换行符，适合代码和预格式化文本；折叠块将换行符转换为空格，适合自然段落文本。转换为 JSON 时，换行符会被转义为 \n。

转换技术类术语

解析（Parsing）

将文本格式的数据按照语法规则转换为程序可操作的数据结构的过程。在 YAML 转 JSON 的场景中，解析分为两个阶段：首先将 YAML 文本解析为内部数据对象，然后将该对象序列化为 JSON 文本。解析的准确性直接决定了转换结果的正确性。

格式化输出（Pretty Print）

在 JSON 输出中添加缩进、换行和空格，使数据结构层次分明、易于阅读的显示方式。格式化输出的 JSON 体积较大，但便于人工阅读和调试。与之对应的是压缩输出（Minified），去掉所有不必要的空白字符以减小文件体积。

安全隐私类术语

客户端处理（Client-side Processing）

所有数据处理操作在用户浏览器（客户端）中完成，数据不经过服务器的处理方式。本工具采用客户端处理模式，YAML 数据的解析和 JSON 转换全部在浏览器内存中执行，从根本上避免了数据在网络传输中被截获的风险。

零数据留存（Zero Data Retention）

工具不会以任何形式保存用户的输入数据。转换完成后，所有数据仅存在于浏览器内存中，刷新页面或关闭标签页后数据即被清除。这种设计理念特别适合处理包含敏感信息的配置文件。