YAML 调试流程

kubectl、Actions 或 Compose 拒绝文件时，应使用可重复的流程，而不是随机改缩进。

第 1 步：拿到准确文件内容

从 git 复制失败文件——不要截图，也不要用 Slack 里可能被智能引号改过的片段。隐藏字符会导致误判。

第 2 步：校验但不改动原文

先用「仅校验」模式。你需要的是对 当前文本 的解析反馈，而不是自动格式化后掩盖原始错误。

第 3 步：跳到行列位置

「第 18 行第 3 列」一类提示对应具体缩进或 token。先修该处，再考虑整文件格式化。

第 4 步：格式化并审查 diff

语法正确后，按团队缩进规范格式化。阅读 diff——格式化不应改变语义，只应改变空白（以及可选的键顺序）。

第 5 步：卡住时用 JSON 往返

若 YAML 来自 JSON 工具链，可 YAML → JSON → YAML，暴露结构异常。若 JSON 已不对，先修数据模型再纠结缩进。

第 6 步：用原工具复验

kubectl dry-run、重新跑工作流，或 docker compose config——领域校验能发现解析器看不到的问题（未知字段、API 版本错误等）。

安全提醒

勿把生产密钥粘贴进可分享的格式化链接。协作时使用脱敏示例。