ARG作用域限于当前构建阶段，跨阶段需显式重声明；--build-arg值会广播至所有同名ARG，但各阶段必须独立声明才能生效。
不能直接跨层传递，必须在每个构建阶段显式重新声明 ARG。 Docker 的 ARG 作用域严格限定在当前 FROM 开始的构建阶段内，前一阶段的 ARG 值不会自动带入下一阶段，哪怕变量名相同、值也一致——这是设计使然，不是 bug。
为什么 FROM 后的 ARG 突然“失效”了
常见现象是：在第一个阶段写了 ARG VERSION=1.0，RUN echo $VERSION 能打印；但进入第二个 FROM alpine 后，再写 RUN echo $VERSION 就输出空字符串。
- 根本原因：
ARG生命周期只到上一个FROM指令结束，新阶段是全新构建上下文 - 即使你没写
ARG VERSION，Docker 也不会继承前一阶段的声明或值 - 多阶段中若漏掉某阶段的
ARG声明，后续所有引用都静默为空，不报错也不警告
如何在多阶段中安全复用同一参数值
必须为每个需要该变量的阶段单独声明 ARG，且构建命令只需传一次 —— Docker 会把 --build-arg 的值广播给所有阶段中同名的 ARG 声明。
- 在 Dockerfile 中每个阶段开头都加一行：
ARG APP_VERSION - 确保所有阶段的
ARG名字完全一致（大小写敏感） - 构建命令保持简洁：
docker build --build-arg APP_VERSION=2.3.1 -t myapp . - 若某阶段需不同默认值，可在该阶段内覆盖声明：
ARG APP_VERSION=dev-snapshot（但会覆盖全局传入值）
ARG 和 ENV 组合时容易忽略的关键点
很多人想让构建参数“透传”到运行时镜像里，于是写 ARG NODE_ENV + ENV NODE_ENV=$NODE_ENV，结果发现容器启动后 $NODE_ENV 是空的。
- 问题出在：如果
ENV NODE_ENV=$NODE_ENV写在第二阶段，但第一阶段没声明ARG NODE_ENV，那第二阶段的ARG NODE_ENV实际没被赋值（因构建命令只传了一次，但第一阶段没接收，导致值丢失） - 正确做法：每个阶段只要用到该变量，就声明；最终运行阶段的
ENV才能拿到真实值 - 更稳妥的写法：
ARG NODE_ENV=production（带默认值），再ENV NODE_ENV=$NODE_ENV，避免因漏传导致空值 - 注意：
ENV是在构建时展开的，不是运行时动态读取，所以它固化的是构建那一刻的$NODE_ENV值
别指望 ARG 自动“穿透”到 COPY 或 LABEL 之外的地方
ARG 只对它所在阶段内、声明位置之后的指令生效。尤其要注意几个典型陷阱：
-
FROM $BASE_IMAGE必须在ARG BASE_IMAGE之后且在同一阶段开头，否则解析失败 -
COPY --from=builder /app/build/ /app/不受任何ARG影响，它只认阶段名，不认变量 -
LABEL version=$APP_VERSION能用，但前提是该ARG APP_VERSION已在本阶段声明过 - 不要在
RUN中用source .env试图加载构建参数 ——.env是运行时文件，ARG是构建期注入，二者不在一个时空
最常被忽略的一点：ARG 的“可见性”不是靠代码位置决定的，而是靠阶段边界和声明顺序双重锁定。少写一行 ARG，整个阶段就失去上下文，而且 Docker 不会提醒你。
