必须安装 redhat.vscode-yaml 插件并配置 yaml.schemas，否则 VSCode 仅支持基础语法高亮，无法校验字段拼错（如 imagePullPolicy: Alaways）、漏字段（如 spec.template.spec.containers）等语义错误；需禁用冲突插件、重载窗口、确认语言模式为 YAML，且 schema 路径须匹配、编码为 UTF-8 无 BOM。
不装 redhat.vscode-yaml，VSCode 就只认缩进和冒号，imagePullPolicy: Alaways 这种拼错值、spec.template.spec.containers 漏字段，全都不会标红——你看到的只是“语法高亮”，不是“校验”。
必须只留 redhat.vscode-yaml，禁用所有 YAML 相关冲突插件
VSCode 1.86+ 自带基础 YAML 支持，但它会和非 Red Hat 插件抢语言服务器，导致补全失效、悬停无响应，甚至报 Connection refused。常见冲突项包括：
- 名字含
YAML Tools、YAML Validation、Auto Close Tag的扩展（哪怕图标很专业） -
esbenp.prettier-vscode：必须在settings.json中加"prettier.disableLanguages": ["yaml"] - 装完后务必执行
Cmd+Shift+P→ 输入Developer: Reload Window，旧进程常驻内存，不重载就卡死
yaml.schemas 不配，等于没校验
没配 yaml.schemas，插件只会检查冒号、引号、缩进；Kubernetes 字段名、GitHub Actions 的 on.push.branches 是否合法——全都不会校验。关键点：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 内置快捷名直接用：
"kubernetes": "**/*.yaml"（自动拉官方最新 Schema） - 远程 URL 必须返回 HTTP 200：
"https://json.schemastore.org/github-workflow.json": "/.github/workflows/*.yml" - 本地 Schema 路径必须是相对工作区根目录：
"./schema/k8s.json": ["k8s/*.yml"]✅，不能写~/project/schema.json❌ - 本地文件编码必须是 UTF-8 无 BOM，否则静默失败，控制台也无报错
格式化失效？检查默认格式化器和语言模式
按 Shift+Alt+F 没反应，或格式后缩进错乱，大概率是格式化器没绑定或语言模式识别失败：
- 在
settings.json中明确指定："[yaml]": { "editor.defaultFormatter": "redhat.vscode-yaml", "editor.formatOnSave": true } - 右下角状态栏必须显示
YAML（不是Plain Text或JSON），点它 → 选Configure File Association for '.yml'→ 设为YAML - 缩进统一设为 2：
"editor.tabSize": 2，多数 CI 工具和kubectl只认 2 空格 - 若格式后
true/false被转成True/False，说明误启用了yaml.format.singleQuote——YAML 不支持单引号布尔字面量
缩进错误定位不了？打开空白字符可视化
插件报 Expected indentation of 4 spaces but found 2，但你看不出哪行多/少空格——因为 VSCode 默认不显示空白字符：
- 在设置中搜
renderWhitespace，设为"all"：空格显示为·，Tab 显示为→ - 别信状态栏显示的
Spaces: 2：它只表示“你用了 2 空格”，不代表“这行该缩进 2 空格” - 建议关闭
editor.detectIndentation（设为false），避免开头注释或空行误导缩进推导
最易被忽略的是 yaml.schemas 路径匹配逻辑和文件编码——路径写错一个斜杠、Schema 文件带 BOM，校验就彻底静默失效，连控制台都不报错。
