根本原因是yaml解析器严格依赖缩进一致性而非“视觉对齐”，必须先通过ctrl+shift+8显形空格（·）和tab（→）才能定位混用；再禁用自动探测、强制插入空格、配置red hat yaml插件并启用保存时格式化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
YAML配置文件因缩进错一位就解析失败，报错信息如did not find expected key或found character '\t'，根本原因不是写错了内容，而是编辑器没把空格和Tab“显形”，你根本看不到哪行混用了缩进字符。
让隐藏的缩进字符现形
打开 VS Code，按下 Ctrl+Shift+8（macOS 是 Cmd+Shift+8），立即看到所有空白符：空格显示为·，Tab 显示为→。
这一步不能跳过——不打开它，你永远在盲调。同一缩进层级若同时出现·和→，就是混用铁证；若某行开头是→而其他行是····，说明该行用了 Tab，必须处理。
注意：【不要选 editor.renderWhitespace: "boundary"】，它只在行首/行尾标点，中间缩进里的 Tab 会被漏掉，导致误判。
强制统一为空格缩进
方法一：对当前文件一键转换
按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）→ 输入 Convert Indentation to Spaces → 回车执行。
方法二：永久关闭自动探测，避免被旧文件带偏
在项目根目录的 .vscode/settings.json 中写入："editor.detectIndentation": false"editor.insertSpaces": true"editor.tabSize": 2
这两步必须同时做：detectIndentation 不关，打开一个带 Tab 的老文件，整个编辑器就会自动切到 Tab 模式，后续所有新行都插 Tab；insertSpaces 不开，按 Tab 键插出来的还是 \t，不是空格。
用 yamllint 扫描已有配置文件
第一步：安装 yamllint
终端执行 pip install yamllint（全局）或 pipx install yamllint（推荐）。
第二步：在项目根目录创建 .yamllint 文件，写入：extends: defaultrules: indentation: spaces: 2 trailing-spaces: enable document-start: enable
第三步：运行扫描yamllint *.yaml 或 yamllint deploy/*.yaml。
它会精准指出哪一行缩进多1个空格、哪一行用了 Tab、哪一行结尾多了空格——比肉眼快十倍。
执行前先 git add -u && git commit -m "chore: before yamllint"，因为 yamllint 修正后 Git 会标记所有缩进行变更，方便回溯。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
VS Code 自动格式化生效的关键配置
确保已安装 Red Hat 官方 redhat.vscode-yaml 插件（不是 “YAML Language Support” 等替代品）。
在项目级 .vscode/settings.json 中写入："[yaml]": { "editor.defaultFormatter": "redhat.vscode-yaml", "editor.formatOnSave": true, "editor.insertSpaces": true, "editor.tabSize": 2, "editor.detectIndentation": false}
重点：格式化只对语法识别正确的文件生效。右下角语言标识必须是 YAML，不是 Plain Text 或 JSON；如果不是，按 Ctrl+Shift+P → 输入 Change Language Mode → 选 YAML 手动切换。
保存即格式化，无需手动触发。缩进错位、冒号后缺空格、嵌套层级突变等问题全部自动对齐。
Sublime Text 中修复 YAML 缩进的硬性前提
第一步：装插件
通过 Package Control 安装 YAML for Kubernetes（作者 mattfoster），不是 “Better YAML” 或泛用 YAML 插件。
第二步：重启 Sublime
部分版本不重启不加载新语法，装完立刻关掉再打开。
第三步：手动绑定语法
打开 deployment.yaml → 点右下角语言名 → Open all with current extension as… → 选 YAML (Kubernetes)。
验证是否成功：apiVersion: 变蓝、kind: 变绿、metadata.name: 变紫；spec.containers[].ports[] 能逐层折叠。如果全灰白，说明还在用自带 YAML，必须重做第三步。
【必须关掉 detect_indentation】：在 Preferences → Settings – User 中加 "detect_indentation": false，否则打开文件时它会扫描前几行并覆盖你的 tab_size 和 translate_tabs_to_spaces 设置。
