Kubernetes 清单缩进错了为什么比写错镜像名还难排查？
发版前项目 owner 被拉进变更群，研发丢来 Deployment、Service、Ingress 与 HPA 四段清单，只说「再确认」。YAML 把结构绑在空格上：spec 若被缩进挂到 metadata 同级，kubectl 有时仍能解析却生成你没想到的对象关系，等线上存活探针全红再回来找行号已是例行加班。大家搜「kubernetes yaml 格式化」「k8s deployment 缩进」「ingress 清单 校验」是为了在 MR 与变更单里先把 metadata、spec、template 三层摊平，对着 labels、selector、containerPort 是否落在 intended 子树里逐项指认。HPA 与 PodDisruptionBudget 这类横切资源更容易因复制粘贴丢一层缩进而悄悄指错 workload。Helm Chart、Kustomize patch 或含 Go template 的文件必须先渲染成纯 YAML 再排版，否则花括号与管道符会被误当成标量。签字前仍应配合客户端 dry-run、准入控制器与命名空间配额策略复核，本页只降低人眼误读与评审沟通成本，不替代集群侧真相。NetworkPolicy 与 Service Mesh sidecar 注入片段也常与 Deployment 同次变更混贴，缩进错位时看起来像同一资源，实则落在 annotation 邻居下面被忽略。把「kubectl explain 官方说明」「kubectl diff 计划输出」与「先浏览器排版再 dry-run」写进变更单固定步骤，能把周末应急里口头对齐的半小时变成可勾选、可审计的两段动作。
如何在评审前把 Kubernetes YAML 理到可指认、可 dry-run 的状态
- 从变更单复制目标资源片段，优先只贴本次改动的对象，避免把整仓 Helm dump 一次性塞进浏览器；若含多文档分隔符，确认每段 apiVersion/kind 与文件名意图一致后再排版。
- 格式化后自上而下核对：selector 与 template.metadata.labels 是否仍互指、volumeMounts 与 volumes 是否同名对齐、readinessProbe 是否写在 container 子树而非 pod 顶层；发现异常立即回到 Git diff 而不是在群里描述「好像少了一层」。
- 将整理稿贴回 MR 描述或变更系统前，与研发约定同一缩进宽度并在本地执行 kubectl apply --dry-run=client 或等效流水线任务；含镜像拉取凭据、TLS 私钥的字段必须先替换占位符，再截图用于评审。
K8s YAML 常见问题
仓库里同时存在 Helm 模板与渲染后的 manifests，我对哪一份做 YAML 排版才不会把 Go template 指令弄坏？
应只对「将要 apply 的渲染结果」排版，模板源文件里的 if、range、include 不是合法 YAML 标量；在 CI 里固定 helm template 或 kustomize build 命令，再把输出喂给格式化与策略扫描。若对模板文件强行排版，可能破坏管道符换行导致渲染失败。
在线工具排版会不会偷偷改我的 replicas 或把 strategy 字段删掉，从而影响线上容量？
合规格式化只应调整空白与可选键序，不应改写数值字段；若你观察到 replicas 变化，多半是粘贴时丢了片段或把两段资源粘在一起。仍要以 Git diff 与 dry-run 计划输出为准，本页不连接集群也不执行 apply。
自定义资源 CRD 的字段在集群里合法，但浏览器 lint 报未知键，这种告警应该忽略还是说明我们的校验链过时了？
应以目标集群已安装的 CRD OpenAPI 与 kubectl explain 为准更新校验规则；浏览器侧多为通用 YAML 能力，无法感知你司私有扩展。把「未知键」截图附在工单里推动平台组升级 schema，而不是静默忽略以免误放行破坏性字段。
Ingress 里 annotations 特别长且含引号与逗号，格式化后顺序变了，是否会导致某些控制器把同一注解当成不同字符串？
映射键在 YAML 层通常无序，控制器应按键名读取；若你们曾依赖「书写顺序」这种未文档化行为，应改为拆分多个注解或升级到支持结构化配置的 CRD。评审时对比排序前后字节级差异，必要时在仓库禁用键排序对该文件生效。
我要把含内网镜像仓库地址与拉取密钥名的清单贴进页面排版，安全同事说即使不 apply 也有泄露风险，有没有可接受的折中做法？
折中仍是脱敏：镜像改为公共占位、imagePullSecrets 改名 fake、host 改为 example.net；在独立浏览器配置文件中操作并清空输入。若制度禁止任何网页接触真实清单，请只用合成样例对齐结构，真实文件留在内网 IDE 与 Git。