hadolint插件在vs code中需手动配置json schema才能生效：必须将.hadolint.yaml/.yml绑定本地contrib/hadolint.json文件，通过.vscode/settings.json中json.schemas精确匹配路径，且failure-threshold和ignored字段须严格按字符串和数组格式书写，否则配置被跳过。
Hadolint 插件在 VS Code 中默认不生效，必须手动配置 JSON Schema 才能触发语法提示、错误高亮和自动补全。
VS Code 必须绑定 .hadolint.yaml 到 Hadolint schema 文件
VS Code 不会自动识别 .hadolint.yaml 为 Hadolint 配置文件，即使文件名完全匹配。它依赖 json.schemas 设置将文件路径与 schema 关联。
- schema 文件需从 Hadolint 官方仓库获取：
contrib/hadolint.json（不能用网络 URL，必须本地路径） - 文件匹配模式必须精确：仅
".hadolint.yaml"或".hadolint.yml"，不支持hadolint.yaml（无前导点） - 如果项目根目录下有
.vscode/settings.json，直接添加配置；否则需新建该文件 - 配置后需重启 VS Code 窗口或重载窗口（
Ctrl+Shift+P→Developer: Reload Window），否则编辑器不会加载新 schema
failure-threshold 和 ignored 是最常配错的两个字段
这两个字段直接影响 lint 结果是否阻断 CI 或本地保存，但类型和取值范围容易误写：
-
failure-threshold只接受字符串："error"、"warning"、"info"，不能写成error（无引号）或WARNING（大小写敏感） -
ignored必须是字符串数组，每个元素是规则 ID，如"DL3006"；写成DL3006（无引号）或["DL3006", DL3018]（混合引号）会导致整个配置被跳过 - 规则 ID 区分大小写，
sc1010无效，正确写法是"SC1010" - 若同时配置了 CLI 参数（如
hadolint --failure-threshold error Dockerfile），CLI 值会覆盖配置文件中的failure-threshold
VS Code 内置 Docker 扩展与 Hadolint 插件存在检测优先级冲突
VS Code 自带的 Docker 扩展会对 Dockerfile 提供基础语法校验（比如指令拼写、缩进），但它不执行规则检查；Hadolint 插件才做深度 lint。两者共存时容易误判问题来源：
- 红色波浪线来自哪个扩展？看状态栏右下角语言模式旁的提示：显示
Hadolint表示是它报的错，显示Docker则是内置扩展的语法警告 - 内置 Docker 扩展无法禁用单条规则，而 Hadolint 可以通过
ignored精确过滤；若想关闭某条警告，必须确保它是 Hadolint 报出的 - 若启用多个 linter（如 ESLint + Hadolint），建议在
.vscode/settings.json中显式关闭非必要校验："docker.enableSyntaxValidation": false
真正起作用的不是插件安装本身，而是 schema 绑定 + 配置文件路径 + 字段格式三者严丝合缝。少一个环节，VS Code 就只会把它当普通 YAML 文件处理——连 trustedRegistries 这种字段拼错都不会报错，因为根本没走验证逻辑。
