Dockerfile报错需先看构建日志定位unknown instruction或invalid reference format等提示，确认指令全大写、拼写正确（如FROM非from）、位置合规（FROM须为首行），弃用MAINTAINER改用LABEL，EXPOSE仅接端口号，并用Hadolint或VS Code插件预检语法。
直接看构建日志里报错的那行，docker 会明确指出哪条指令不识别或语法不合法，比如出现 unknown instruction 或 invalid reference format 这类提示，基本就是拼写或大小写问题。
检查指令是否全大写且拼写正确
Dockerfile 所有指令必须是全大写的英文单词，例如 FROM、RUN、COPY、ENV。常见错误包括：
- 写成小写或首字母大写：from、From、run、Copy
- 拼错指令名：FRON（少个M）、RNU、ADDD、CMMD
- 把指令当参数用：比如在 RUN 后面误写一个 FROM，导致 Docker 认为那是新指令
确认指令位置和上下文是否合规
有些指令对位置敏感，放错地方会直接报错：
- FROM 必须是第一个非注释行，不能出现在 RUN 或 COPY 后面
- MAINTAINER 已被弃用，若还在用会报错，应改用 LABEL maintainer=...
- EXPOSE 后面只能跟端口号，不能带协议或多余字符，如 EXPOSE http://80 是非法的
用工具提前检测语法问题
别等构建失败再排查，本地就能预防：
- 安装 Hadolint（推荐）：它能静态分析 Dockerfile，标出拼写、大小写、废弃指令等问题
- 运行 docker build --no-cache -f Dockerfile . 时加 --progress=plain，让错误输出更清晰
- 编辑器插件辅助：VS Code 安装 “Docker” 官方插件，可实时高亮语法错误
对照官方文档快速验证
遇到不确定的指令，不要凭记忆写：
- 打开 Docker 官方 Dockerfile 指令文档
- 复制标准写法，替换其中的值，避免手误
- 特别注意易混淆指令：COPY 和 ADD 功能不同，CMD 和 ENTRYPOINT 行为差异大，写错不会立刻报拼写错，但会导致运行异常
