UD5工具箱
Q1：YAML 和 JSON 格式的主要区别是什么？
YAML 和 JSON 的核心区别体现在三个方面：语法风格上，YAML 以缩进和换行为主要分隔方式，视觉上更接近自然语言，可读性极佳；JSON 使用花括号和方括号作为结构标记，格式更紧凑严格。功能特性上，YAML 支持注释（以 # 开头）、锚点引用（& 和 *）、合并键（<<）等高级特性，而 JSON 不原生支持这些功能。数据类型上，两者都支持字符串、数字、布尔值和空值，但 YAML 的类型推断更灵活。在实际开发中，YAML 常用于人工编写和阅读的配置文件，JSON 则更常用于机器之间的数据交换和 API 通信。
Q2：转换后 YAML 中的注释为什么丢失了？
这是符合标准行为的设计选择。JSON 格式本身不支持注释语法，这是 JSON 规范（RFC 8259）明确定义的。因此在 YAML 转 JSON 的过程中，所有以 # 开头的注释行会被解析器自动跳过，不会出现在转换结果中。如果您需要在 JSON 中保留说明信息，建议将这些信息作为键值对存储，例如添加 _comment 或 _description 字段。部分 JSON 解析器支持以双下划线开头的键名作为非标准注释方案，您可以在自己的应用中选择合适的处理方式。
Q3：工具对 YAML 高级特性（锚点、合并键、多行字符串）的支持情况如何？
本工具基于成熟的 js-yaml 解析库，完整支持 YAML 1.2 规范中的高级特性。具体包括：锚点（&name）和别名（*name）引用会被正确解析和展开；合并键（<<）语法支持单个和多个锚点合并，遵循键名覆盖优先级规则；多行字符串中，字面量块（|）保留所有换行符，折叠块（>）将换行转换为空格，支持 |+（保留末尾换行）和 |-（去除末尾换行）变体。此外还支持复杂键、流式集合、类型标签等特性。如果您遇到某个高级特性的转换问题，请检查 YAML 语法是否完全符合规范。
Q4：为什么出现「YAML 语法错误」提示？缩进问题怎么排查？
YAML 对缩进规则非常严格，这是最常见的语法错误来源。排查缩进错误请关注以下几点：第一，必须使用空格缩进，绝对不能使用 Tab 字符，如果您的编辑器设置了 Tab 缩进，请在粘贴前转换为空格。第二，同一层级的缩进量必须一致，例如所有二级缩进都使用4个空格，不能混用2个和4个。第三，列表项的 - 符号后面必须有一个空格。第四，冒号 : 后面的值前面通常也需要一个空格。工具的错误提示会显示具体的行号，您可以直接定位到错误行进行修复。建议在编辑器中开启「显示空白字符」功能来辅助排查。
Q5：YAML 中的多行字符串（| 和 >）转换后变成了什么？
YAML 的多行字符串语法在转换为 JSON 后会有以下变化：使用管道符 | 定义的字面量块（Literal Block Scalar）会保留所有换行符，转换为 JSON 字符串后换行符显示为转义序列 \n。使用大于号 > 定义的折叠块（Folded Block Scalar）会将换行符转换为空格，但连续空行会被保留为换行符。变体符号 |+ 和 |- 分别控制是否保留末尾换行。在 JSON 输出中，多行字符串会显示为带有 \n 转义的单行字符串。如果您需要还原为多行显示，可以使用「格式化」功能或在代码中进行字符串替换处理。
Q6：YAML 中的布尔值和空值在 JSON 中如何表示？
YAML 的布尔值表示非常灵活，支持多种写法：true、True、TRUE、yes、Yes、YES、on、On、ON 都表示真值；false、False、FALSE、no、No、NO、off、Off、OFF 都表示假值。但转换为 JSON 后，所有真值统一表示为 true，所有假值统一表示为空。空值方面，YAML 中的 null、Null、NULL、~ 以及空值都会被转换为 JSON 的 null。需要注意的是，YAML 中不加引号的 yes/no 在某些解析器中可能被识别为布尔值而非字符串，如果您希望保留为字符串，建议使用引号包裹。本工具使用 js-yaml 默认配置，会将这些宽松写法识别为布尔值。
Q7：能否将 JSON 转换回 YAML？工具是否支持双向转换？
目前本工具专注于 YAML 到 JSON 的单向转换。如果您需要将 JSON 转换为 YAML 格式，推荐使用以下替代方案：一是使用在线 JSON 转 YAML 工具，ud5.com 上搜索即可找到相关工具；二是使用命令行工具，Node.js 环境下可以使用 js-yaml 库的 dump 方法，Python 环境下可以使用 PyYAML 库的 dump 方法；三是在代码中直接引入 JSON 和 YAML 的转换库进行编程处理。未来我们计划在工具中增加双向转换功能，敬请期待。
Q8：转换后的 JSON 结果中中文字符显示正常吗？
完全正常。本工具的转换引擎原生支持 Unicode 编码，YAML 中的中文、日文、韩文以及各种特殊字符都会被完整保留。转换后的 JSON 结果默认使用 UTF-8 编码，中文字符直接以原字符形式显示在输出中，无需额外的编码转换步骤。如果您的应用场景需要 JSON 字符串中的中文以 Unicode 转义序列（如 \u4e2d\u6587）形式存储，可以在代码层面进行后处理转换。但对于绝大多数实际使用场景，直接使用原始字符形式更为方便和可读。
Q9：工具对大型 YAML 文件的处理能力如何？有没有大小限制？
本工具基于浏览器内存进行数据处理，理论上可以处理数十 MB 大小的 YAML 文件，但实际性能取决于您的设备配置和浏览器内存限制。对于 1MB 以内的文件，转换通常是瞬时完成的；1MB 到 10MB 的文件可能需要短暂等待；超过 10MB 的文件建议分段处理以获得最佳体验。如果您在处理大型文件时遇到浏览器响应变慢的情况，建议关闭其他标签页释放内存，或使用 Chrome 浏览器（其 V8 引擎的 JavaScript 性能最优）。对于超大型配置文件（100MB 以上），建议使用命令行工具（如 Node.js 的 js-yaml CLI）进行本地转换。
Q10：使用本工具转换的数据安全吗？YAML 内容会不会被上传到服务器？
绝对不会。本工具采用纯客户端架构，所有数据处理流程都在您的浏览器本地完成。具体来说，YAML 文本的解析、类型推断、JSON 序列化等全部操作通过浏览器内置的 JavaScript 引擎执行，整个过程中没有任何网络请求将您的数据发送到外部服务器。转换完成后，结果数据仅暂存于浏览器内存中，页面关闭或刷新后即被完全清除。我们不会以任何形式记录、存储或分析您输入的内容。这种架构设计使其特别适合处理包含敏感信息的配置文件，如数据库连接字符串、API 密钥、内部服务地址等敏感配置。