必须在工作区.vscode/settings.json中配置"prettier.disableLanguages": ["yaml"]、"[yaml]": {"editor.defaultFormatter": "redhat.vscode-yaml", "editor.insertSpaces": true, "editor.tabSize": 2, "editor.detectIndentation": false}，并开启renderWhitespace:"all"可视化排查混用。
为什么装了 YAML 插件缩进还是错？
不是插件没起作用，而是它被别的格式化器抢了控制权。VSCode 的 Shift+Alt+F 实际调用的是当前语言绑定的 editor.defaultFormatter，如果 esbenp.prettier-vscode 或其他扩展已抢占 YAML 的默认格式化器位置，redhat.vscode-yaml 就完全不参与——你看到的“整齐缩进”其实是 Prettier 按 JS 规则硬套出来的假象。
常见现象包括：env: 和 ports: 看似同级对齐，但实际嵌套在 containers: 下时仍报错；或格式化后所有键突然缩进 4 格而非预期的 2 格。
- 右下角状态栏点击语言标识，确认是
YAML（不是Plain Text或JSON） - 按
Ctrl+Shift+P→ 输入Format Document With…，检查列表中是否出现YAML Language Server - 若没出现，大概率是
prettier-vscode在拦截：需在设置中加"prettier.disableLanguages": ["yaml"]
如何强制 redhat.vscode-yaml 成为唯一 YAML 格式化器？
关键不是“装了”，而是“被正确绑定”。必须在工作区级配置中显式声明，且覆盖所有可能冲突路径：
- 在项目根目录创建或编辑
.vscode/settings.json，写入以下内容（注意不是用户级settings.json）： "editor.formatOnSave": true"[yaml]": { "editor.defaultFormatter": "redhat.vscode-yaml", "editor.insertSpaces": true, "editor.tabSize": 2, "editor.detectIndentation": false }- 删掉任何其他扩展对
[yaml]块的覆盖（比如prettier或beautify的同类配置）
特别注意："editor.detectIndentation": false 必须设在这里——否则打开一个带 Tab 的旧文件，整个工作区会立刻切到 Tab 模式，后续所有新行都插 \t，格式化器也救不回来。
已有混用空格/TAB 的 YAML 文件怎么安全修复？
别手动删空格、别全局替换 \t，那样会破坏多行字面量（如 description: | 后的缩进）和注释对齐。真正安全的方式是让 VSCode 底层重写缩进符号，不碰语义层级：
- 打开该 YAML 文件
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P）→ 输入Convert Indentation to Spaces→ 回车执行 - 执行前务必先提交当前变更：
git add -u && git commit -m "chore: before indentation conversion"，因为 Git 会把每行缩进变化标为修改，影响 code review
这个命令只改缩进字符（\t → 空格），不调整缩进量本身。所以它必须配合前面的 "editor.tabSize": 2 和 "editor.insertSpaces": true 才能保证后续新增内容也统一。
为什么开了 renderWhitespace 还看不出缩进问题？
因为你可能用了 "boundary" 模式。VSCode 的 editor.renderWhitespace 有三个值："none"、"boundary"、"all"。只有 "all" 会把每行开头的每个空格显示为 ·、每个 Tab 显示为 →；"boundary" 只标行首/行尾，中间混入的 Tab 完全看不见，极易误判。
开启方式：
- 快捷键：
Ctrl+Shift+8（Windows/Linux）或Cmd+Shift+8（macOS） - 或在设置中搜
editor.renderWhitespace，设为"all" - 开启后，同级键（如
name:、image:）缩进位置必须出现完全相同的符号序列——不能有的是··，有的是→
这一步跳过，后面所有格式化、转换、校验都是在盲操作。缩进错误从来不是“写错了”，而是你看不见那几个隐藏字符。
