Docker 的 FROM 指令不支持环境变量替换，因构建初期需确定基础镜像以初始化上下文，此时 ARG/ENV 尚未生效；正确做法是用前置 ARG 声明并配合 --build-arg 传参。
FROM 指令本身不支持环境变量替换，这是 Docker 官方明确限制的行为。你不能在 FROM 行中直接使用 ENV、ARG 定义的变量（比如 FROM $BASE_IMAGE 或 FROM ${TAGGED_IMAGE}），Docker 构建器会在解析阶段报错：unknown instruction: FROM 或 invalid reference format。
为什么 FROM 不支持变量？
Docker 需在构建最开始就确定基础镜像，用于初始化构建上下文、解析后续指令、设置默认 shell 和工作目录等。此时 ARG/ENV 尚未生效或未被求值，语法层面也未开放变量插值 —— 这是设计使然，不是 bug。
正确做法：用 ARG 配合构建时传参
虽然 FROM 不能直接写变量，但可以借助 ARG 声明构建参数，并在 FROM 中引用（仅限于 ARG 在 FROM 之前声明且未被覆盖）：
- 必须把
ARG放在FROM之前（全局作用域） - 推荐为 ARG 设置默认值，避免构建失败
- 构建时用
--build-arg覆盖默认值
示例：
ARG BASE_IMAGE=ubuntu:22.04<br>FROM $BASE_IMAGE<br>RUN apt-get update && apt-get install -y curl
构建命令：
docker build --build-arg BASE_IMAGE=debian:12 .
进阶技巧：多阶段构建中灵活切换基础镜像
多个构建阶段可各自使用不同 ARG，实现「一套 Dockerfile 适配多种运行时」：
- 每个
FROM前单独声明对应 ARG（如ARG BUILDER_IMAGE、ARG RUNTIME_IMAGE） - 不同阶段引用不同变量，互不影响
- 适合 CI 中按平台/架构/版本动态选择基础镜像
示例片段：
ARG BUILDER_IMAGE=golang:1.22-alpine<br>FROM $BUILDER_IMAGE AS builder<br>COPY . .<br>RUN go build -o myapp .<br><br>ARG RUNTIME_IMAGE=alpine:3.20<br>FROM $RUNTIME_IMAGE<br>COPY --from=builder /workspace/myapp /usr/local/bin/<br>CMD ["myapp"]
常见误区与替代方案
以下写法均无效或不可靠：
-
ENV IMG=nginx:1.25+FROM $IMG→ ❌ ENV 对 FROM 不可见 -
FROM ${IMG}（花括号语法）→ ❌ 同样不支持，Docker 不解析 - 用 shell 脚本生成 Dockerfile → ✅ 可行但增加维护成本，非推荐主流方式
- 用 Makefile 或 CI 模板替换字符串 → ✅ 适用于复杂多变场景，但属于外部工具链
真正轻量又标准的解法，始终是 ARG + --build-arg 组合。
