必须安装 ms-vscode.docker（Microsoft 官方）而非 ms-azuretools.vscode-docker，后者不支持 Dockerfile 高亮与补全；文件名须严格为大小写敏感的 Dockerfile，安装后需重启 VSCode 并确认右下角语言模式为 Dockerfile。
Dockerfile 在 VSCode 里不高亮、没补全，基本就是装错了扩展，不是配置问题，也不是文件写错了。
装错扩展是最大坑：别用 ms-azuretools.vscode-docker
很多人搜“Docker 插件”直接装了 ms-azuretools.vscode-docker，但它只管容器运行、镜像列表、Compose 启停，**完全不处理 Dockerfile 编辑体验**。装完你会发现右下角语言模式还是 Plain Text，FROM/COPY 全是灰色，敲字母也没提示。
- 必须卸载
ms-azuretools.vscode-docker（除非你真要调试远程容器） - 搜索安装
ms-vscode.docker（作者是 Microsoft，名字里没有azuretools） - 装完务必重启 VSCode —— 补全触发逻辑依赖启动时加载的语言服务，不重启可能无效
文件名和语言模式必须对得上
VSCode 只在明确识别为 Dockerfile 时才启用高亮和补全。它认文件名比认内容更死板。
- 标准文件名必须是严格大小写的
Dockerfile（dockerfile、DockerFile都不行） - 如果用了变体名（如
Dockerfile.prod），得手动设置语言模式：Ctrl+Shift+P→ 输入Change Language Mode→ 选Dockerfile - 或者在工作区
.vscode/settings.json里加这条绑定："files.associations": {"Dockerfile.*": "dockerfile"} - 点右下角语言模式确认显示的是
Dockerfile，不是Shell Script或其他
补全能干啥、不能干啥，得心里有数
ms-vscode.docker 的补全是“指令级”的，不是“参数级”或“值级”的。它不会猜你想要哪个镜像，也不会校验你写的参数合不合 Docker 版本。
- 输入
FR会提示FROM，输入COP会提示COPY，这是它能做的 -
FROM node:后面不会弹出镜像版本列表（那是docker-hub-extension或其他插件的事） -
COPY --不会提示--chown或--chmod—— 因为这些开关依赖 Docker 引擎版本（比如--chown是 17.09+ 才支持），插件不做运行时判断 - 输错参数（如
COPY --xxx）也不会报红，VSCode 不校验语法合法性，只做文本匹配
格式化和干扰插件容易打架
装了 ms-vscode.docker 后，如果 docker build 前自动格式化把缩进搞乱了，大概率是别的插件劫持了 formatter。
- 检查设置里搜索
dockerfile.format.provider，确保值是docker，不是prettier或shell-format - 常见冲突插件：
esbenp.prettier-vscode（对.dockerfile后缀误判）、foxundermoon.shell-format（把 Dockerfile 当 Shell 解析） - 临时排查：用
code --disable-extensions启动，再逐个启用，定位谁在抢 formatter 控制权
真正麻烦的从来不是装不上高亮，而是以为补全能帮你填对 --chown 或选对 alpine 镜像——它不能。参数含义、版本兼容性、路径有效性，都得你自己查 docker build --help 或翻 Docker 官方文档。插件只是让 FROM/COPY 这些词变蓝而已。
