Dockerfile中ARG与ENV使用问题：构建后输出为空而非预期值

这个问题我之前也踩过坑！核心原因是你没搞清楚Dockerfile中ARG指令的作用域规则：

Docker的构建过程以FROM指令为分界，分为「构建前阶段」和「镜像构建阶段」。在FROM之前定义的ARG属于全局ARG，它只能用于配置FROM指令本身（比如动态指定基础镜像的版本），无法直接在FROM之后的镜像构建阶段中引用。

你的Dockerfile里，my_arg和other_arg都定义在FROM centos:7之前，所以后续的ENV MY_ENV $my_arg根本拿不到这些ARG的值，自然输出为空。

两种修复方案 #

方案1：将ARG移到FROM之后（推荐） #

把ARG指令放到FROM后面，这样它们的作用域就是当前的镜像构建阶段，后续的ENV就能正常引用：

FROM centos:7
ARG my_arg
ARG other_arg=other_default
ENV MY_ENV $my_arg
ENV OTHER_ENV $other_arg
CMD echo "$MY_ENV $OTHER_ENV"

方案2：在FROM之后重新声明ARG（如果需要全局ARG） #

如果你确实需要在FROM之前定义ARG（比如用来动态选择基础镜像），可以在FROM之后重新声明一次相同的ARG，让镜像构建阶段能访问到它的值：

# 全局ARG，可用于FROM指令（比如 FROM centos:$my_arg）
ARG my_arg
ARG other_arg=other_default
FROM centos:7
# 重新声明ARG，让当前阶段继承全局ARG的值
ARG my_arg
ARG other_arg=other_default
ENV MY_ENV $my_arg
ENV OTHER_ENV $other_arg
CMD echo "$MY_ENV $OTHER_ENV"

验证效果 #

用你原来的构建命令重新构建：

docker build --build-arg my_arg=my_value .

运行镜像后就能得到预期输出：my_value other_default

内容的提问来源于stack exchange，提问作者Thomas Hirsch