基本用法

本指南将引导您了解 JSON 到 YAML 转换器工具的基本用法。

开始使用

步骤 1：访问工具

从主页面导航到 JSON 到 YAML 转换器工具，或直接通过 URL /json-to-yaml 访问。

步骤 2：输入您的 JSON

1. 粘贴 JSON：复制您的 JSON 数据并粘贴到输入文本区域
2. 输入 JSON：手动输入您的 JSON 数据
3. 加载示例：点击"加载示例"按钮查看示例 JSON 结构

步骤 3：自动转换

工具会在您输入或粘贴内容时实时自动将您的 JSON 转换为 YAML。

步骤 4：查看输出

转换后的 YAML 将出现在界面右侧的输出部分。

输入方法

手动输入

• 直接在输入文本区域输入您的 JSON
• 工具支持在您输入时实时转换

从剪贴板粘贴

• 从任何来源（文件、网站、应用程序）复制 JSON
• 使用 Ctrl+V（Mac 上为 Cmd+V）将其粘贴到输入区域

加载示例

• 点击"加载示例"按钮加载示例 JSON 结构
• 这对于测试工具或学习格式很有用

输出选项

复制到剪贴板

• 点击输出旁边的"复制"按钮
• YAML 内容将被复制到您的剪贴板
• 将其粘贴到您需要的任何地方

下载文件

• 点击"下载"按钮将 YAML 保存为文件
• 文件将以 .yaml 扩展名保存

格式化选项

• 格式化：使用适当的缩进美化打印 YAML
• 压缩：删除不必要的空白以生成紧凑输出

基本 JSON 示例

简单对象

{
  "name": "张三",
  "age": 30,
  "city": "北京"
}

对象数组

{
  "users": [
    { "id": 1, "name": "Alice" },
    { "id": 2, "name": "Bob" }
  ]
}

嵌套结构

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "credentials": {
      "username": "admin",
      "password": "secret"
    }
  }
}

错误处理

无效 JSON

如果您的输入包含无效的 JSON：

• 输入下方将出现错误消息
• 输出区域将显示错误指示器
• 修复 JSON 语法后，转换将自动恢复

常见 JSON 错误

• 属性之间缺少逗号
• 不匹配的括号或大括号
• 无效的字符串引号
• 尾随逗号

最佳结果提示

1. 首先验证 JSON：在转换前确保您的 JSON 有效
2. 使用适当的格式化：格式良好的 JSON 产生更清洁的 YAML
3. 检查输出：始终检查转换后的 YAML 的准确性
4. 保存您的工作：使用下载功能保存重要的转换

下一步

一旦您熟悉了基本用法，探索高级功能以了解更强大的选项和自定义设置。