必须安装Microsoft官方Docker扩展（ms-vscode.docker）才能启用Dockerfile语法高亮、指令补全和反模式警告；装错插件（如ms-azuretools.vscode-docker）或未正确关联文件类型将导致功能失效，且需确保本地Docker CLI可用。
Dockerfile 在 VSCode 中默认没有语法提示，必须手动启用插件支持，否则写错指令（比如 COPY 拼成 COPy）或漏掉换行符，docker build 会直接失败，且错误信息不指向具体行。
安装 Docker 扩展是前提，不是可选项
VSCode 自身不识别 Dockerfile 语法，必须安装 Microsoft 官方的 Docker 扩展。它提供三类基础能力：语法高亮、指令自动补全、常见反模式警告（如使用 latest 标签、ADD 替代 COPY）。不装这个扩展，后续所有配置都无效。
- 打开 VSCode → 左侧活动栏点击扩展图标（四个方块）→ 搜索
Docker→ 选择 publisher 为Microsoft的那个 → 点击安装 - 安装后无需重启，新建或打开任意名为
Dockerfile的文件，右下角状态栏会自动显示语言模式为Dockerfile；若显示为Plain Text，需手动点击该区域 → 选择Configure File Association for 'Dockerfile'→ 设为Dockerfile - 扩展依赖本地
dockerCLI 可执行文件。如果终端中运行docker --version报错，VSCode 的 Docker 扩展将无法启动 LSP 服务，导致补全和诊断失效
为什么 RUN 后面的 Shell 命令没提示？
VSCode 的 Docker 扩展只对 Docker 指令本身做语法检查，不对 RUN 后接的 Shell 命令做语义分析。例如 RUN apt-get install -y curl 中的 apt-get 不会高亮拼写错误，也不会提示包名不存在。这是设计限制，不是配置问题。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 想获得 Shell 层面的检查，需额外安装
shellcheck并配合vscode-shellcheck插件，但仅适用于RUN中的单行 Shell（不支持多行续行写法） -
RUN指令推荐用 JSON 数组格式（RUN ["apt-get", "update"]），此时 VSCode 能校验数组结构是否合法，但依然不检查命令是否存在 - 避免在
RUN中写长链式命令（如&&连接多个操作），这会让 Docker 缓存失效，也超出编辑器提示能力范围
如何让 FROM 镜像名自动补全？
VSCode Docker 扩展默认不联网查询镜像仓库，所以 FROM 后输入 ubuntu: 不会弹出版本号建议。需要手动开启 Docker Hub 集成，且依赖本地 Docker daemon 正常运行。
- 确保 Docker Desktop 或 Docker Engine 已启动，且能执行
docker search ubuntu返回结果 - 在 VSCode 设置中搜索
docker suggest→ 勾选Docker > Suggest: Enabled和Docker > Suggest: Include Official Images - 在
FROM行末尾输入冒号（:）后等待 1–2 秒，会出现常用标签（如20.04、22.04、latest）的下拉提示；但私有仓库镜像（如my-registry.com/app:1.0）不会被提示 - 若始终无提示，检查
docker info是否报错，或 VSCode 终端是否使用了非系统默认 shell（某些 zsh 配置会干扰 daemon 连接）
真正容易被忽略的是：Docker 扩展的语法检查能力止步于指令层级，它不会验证 COPY 的源路径是否存在、EXPOSE 的端口是否被应用实际监听、或者 WORKDIR 目录是否在镜像中真实可写。这些必须靠 docker build 运行时暴露，编辑器只负责把 FORM 这种低级拼写错误拦在第一关。
