应安装官方插件ms-vscode.docker而非ms-azuretools.vscode-docker，它提供Dockerfile语法高亮、指令补全和格式化；需手动绑定文件关联并重启VSCode。
装错插件是 Dockerfile 没高亮的最常见原因
VSCode 默认完全不识别 Dockerfile 语法，连 FROM 都是灰色 plain text——这不是配置问题，而是根本没装对扩展。很多人搜“Docker 插件”，结果装了 ms-azuretools.vscode-docker，但它只管容器运行、镜像列表和 docker-compose.yml，**不提供任何语法高亮或指令补全**。
真正起作用的是官方维护的 ms-vscode.docker（注意名字里没有 azuretools）。它由 VSCode 团队直接发布，支持：
-
FROM、COPY、RUN等指令高亮 - 输入
EX自动提示EXPOSE，HE提示HEALTHCHECK - 基础格式化（比如自动缩进、空行处理）
如果你已装了 ms-azuretools.vscode-docker，建议禁用它——两个插件共存时，ms-vscode.docker 的补全常被劫持或静默失效。
文件名和语言模式必须同时匹配
装对插件后仍没反应？大概率是 VSCode 没把当前文件当成 Dockerfile 解析。它只在以下任一条件满足时启用语法支持：
- 文件名严格为
Dockerfile（大小写敏感，dockerfile或DockerFile不行） - 文件名形如
Dockerfile.prod、Dockerfile.nginx，但需手动绑定语言模式
操作方式：
- 点击 VSCode 右下角状态栏的语言标识（如显示
Plain Text），选Configure File Association for 'Dockerfile'，输入Dockerfile回车 - 若用自定义名（如
Dockerfile.ci），在.vscode/settings.json中加："files.associations": {"Dockerfile.*": "dockerfile"} - 改完必须重启 VSCode——部分补全逻辑只在启动时注册
补全不触发？检查这三处干扰点
ms-vscode.docker 的补全不是“随时弹出”，它依赖明确的语言上下文。常见失效场景：
- 右下角语言模式显示为
Shell Script或Plain Text（哪怕你刚点过切换，也可能是临时生效） -
settings.json里存在"docker.suggest.enabled": false这类显式禁用项 - 其他插件抢注了补全提供者，比如某些 Shell / YAML 插件会拦截
FROM开头的行并返回空建议
验证方法：打开一个纯 Dockerfile 文件，输入 FR 后按 Ctrl+Space，看是否弹出 FROM；如果没反应，先禁用所有非必要插件，再逐个启用排查。
别指望它补全镜像名或参数值
这个插件只负责 Dockerfile **指令层**的语义支持，不涉及运行时校验或引擎版本差异。所以：
- 输入
FROM后，它不会列出nginx:alpine、python:3.11-slim等常用镜像（那是 Docker Hub 或第三方插件的事） - 输入
COPY --，不会提示--chmod或--chown（Docker 23.0+ 才支持，插件不感知版本） - 它不检查
RUN apt-get install是否有-y，也不警告ADD替代COPY的风险
真要查这些，得配 hadolint 这类 linter，而不是靠编辑器插件。插件的作用很实在：让你一眼看清哪行是指令、哪行是注释、拼错 ONBUILD 时立刻标红——仅此而已。
