从第一处报错开始，不要同时重排整份文件
YAML 转 JSON 失败时，先复制一份不含密钥、令牌和真实地址的最小片段，只修复工具指出的第一行。YAML 的父子关系依赖缩进，一处层级错位可能让后面的列表和映射连续报错；同时改很多行，反而难以知道是哪次修改真正解决了问题。
例如一份部署配置里，service: 下面有 name: 和 ports:，而 ports: 下面又有两个以 - 开头的端口。先保留这一小段，删除与问题无关的注释和其他服务，再确认同一层级使用相同数量的空格。不要把制表符和空格混在行首。YAML 1.2.2 规范说明，块结构由缩进决定，为了可移植性，制表符不能用于缩进。
先问自己三个问题：报错行应该与上一行同级，还是属于上一行；它是 键: 值 的映射，还是以 - 开头的列表项；冒号后是同一行的值，还是下一层结构。把关系说清楚后再移动空格，比盲目格式化更可靠。
用基础结构检查缩进、冒号和列表层级
打开YAML JSON 互转工具，把脱敏的小片段放到 YAML 一侧，再执行 YAML → JSON。当前 yaml-json 组件会读取基本的嵌套映射、列表、单引号或双引号字符串，以及常见的布尔值、空值、整数和简单小数。转换成功后，右侧会生成带缩进的 JSON，便于观察父子层级。
遇到缩进错误时，按这个顺序排查：
- 行首是否含 Tab；编辑器看起来对齐，不代表字符相同。
- 同一父节点下的键是否处于相同列。
- 列表项的
-是否都属于同一个缩进层级。 key:后面没有同一行值时，下一行是否确实比它缩进更深。- 同一个块里是否把列表项和普通映射项混在同一级。
- 含冒号或井号的字符串是否需要引号，避免被当成结构或注释。
例如订单处理配置可先只保留 jobs: 与两个任务。每个任务用 - name: 开头，后续的 queue: 要与该任务的其他字段对齐。如果第二个任务少缩进两个空格，它可能被解释成上一级键，或触发“unexpected indentation”。修复第一处后重新转换，再处理下一条错误。
先确认工具边界，合法 YAML 也可能不在支持范围内
这个页面是基础 YAML 子集转换器，不是完整 YAML 1.2.2 处理器。当前组件会明确拒绝 | 或 > 块标量、& 锚点、* 别名、标签、合并键以及以方括号或花括号写成的流式集合。规范本身包含这些能力，因此一份对其他解析器有效的高级 YAML，仍可能在这里显示“不支持”。
这类提示不应通过删除语义来“修好”。例如配置用锚点复用默认参数时，直接删掉锚点与别名可能让某些环境失去必要字段。正确做法是回到使用该配置的程序，使用它认可的解析器或命令进行验证；若只是为了在当前工具查看层级，可在单独的脱敏副本中展开结构，并保留原文件作为来源。
块标量也要特别小心。多行证书、脚本或说明经常使用 | 或 >，当前工具不支持这种输入。不要把多行内容随意合并成一行后再用于生产配置，因为折行和换行可能具有实际含义。此时应停止转换，改用目标平台的官方校验器。
转成 JSON 后逐项核对类型和缺失字段
出现 JSON 输出，只代表当前子集被解析成了一个数据结构，不代表字段满足 Kubernetes、CI 系统、API 或应用程序的 schema。先展开右侧结果，核对对象和数组的位置，再检查值的类型。"false" 是字符串，false 才是布尔值；"8080" 与 8080 也可能被目标程序区别处理。
空值同样需要确认。只有键而没有值时，当前解析会得到 null；引号中的空字符串则是 ""。目标程序可能把二者理解为“没有设置”和“明确设置为空”，不能仅凭 JSON 语法决定哪一个正确。
可以把生成结果粘贴到JSON 格式化与验证工具，再次确认 JSON 能被标准解析器读取并查看层级。它只能检查 JSON 语法和排版，无法判断字段名、必填项、端口范围或部署权限。最终仍要运行目标程序提供的 dry-run、lint 或 schema 校验。
保存修复前后片段并做最小验证
在配置真正交给程序前，保留原始片段与修复片段。把两份文本放进文字差异比对工具，按行查看变化是否只包含预期的空格、引号或字段调整。text-diff 不理解 YAML 语义，所以它能说明“哪里变了”，不能证明“改得对”。
例如修复一个 CI 任务时，理想差异可能只有 steps: 下两行多了两个空格。如果差异同时出现密钥、镜像标签或执行命令变化，应先分开处理，避免把结构修复和业务变更混在一次提交里。
最后用目标系统的安全验证入口处理最小样本，再扩大到完整文件。若系统仍报错，区分 YAML 解析错误、schema 字段错误、权限错误与运行时错误；它们需要不同的修复路径。转换器输出不是部署成功证明，也不能替代目标环境的人工确认。
常见问题
为什么看起来对齐的 YAML 仍然报缩进错误？
行首可能混入了 Tab，或同级行实际使用了不同数量的空格。开启编辑器的空白字符显示，从第一条报错附近开始统一为空格，再转换最小片段。
工具提示不支持锚点或块标量，是否说明 YAML 无效？
不一定。YAML 1.2.2 包含锚点、别名和块标量，但当前工具只实现基础子集。请使用目标程序认可的完整解析器验证，不要为了通过本工具而删除必要语义。
转换后的数字和布尔值一定符合目标程序吗？
不能保证。先区分有引号的字符串与没有引号的数字、布尔值，再根据目标 schema 检查类型。JSON 语法正确不代表业务字段正确。
YAML 中的注释会保留到 JSON 吗？
不会。JSON 输出只表达解析后的数据结构，注释不会成为普通 JSON 字段。需要保留说明时，应继续保存原始 YAML 或另行维护文档。
可以把含生产密钥的配置直接粘贴进去吗？
不建议。即使组件在浏览器中处理文本，剪贴板、扩展程序、屏幕录制和组织政策仍可能带来风险。优先使用脱敏的最小片段，并在获准的环境运行正式验证。