Docker构建时Shell环境变量传递问题：需显式声明关联？

你说得完全没错！很多刚接触Docker的开发者都会踩这个坑：执行docker build命令的Shell里导出的环境变量，默认不会自动传递到Docker构建上下文中。比如你在Shell里跑了export FOO=bar，然后直接在Dockerfile里写RUN echo $FOO，构建的时候这条指令输出的只会是空字符串，根本拿不到你在Shell里设置的bar。

这其实是Docker的设计逻辑：构建过程是在一个独立隔离的环境里运行的，和执行build命令的Shell环境完全分开，目的是保证镜像构建的可重复性——要是随便继承Shell里的变量，那不同机器、不同终端下构建出来的镜像可能就不一样了，这显然不符合Docker“一次构建，到处运行”的理念。

那要让Shell里的环境变量能在构建时用上，就得用显式的声明+传递方式，这里给你两种最常用的方法：

方法1：用--build-arg逐个传递变量 #

这是最灵活的方式，适合单个或少量变量的场景：

1. 先在Shell里设置好变量：

export FOO=bar

2. 在Dockerfile里用ARG指令声明要接收这个变量：

# 声明要接收的构建参数
ARG FOO
# 现在就能在构建步骤里用这个变量了
RUN echo "构建时的FOO值：$FOO"

3. 执行构建命令时，通过--build-arg把Shell变量传进去：

docker build --build-arg FOO=$FOO .

这样构建过程中，RUN echo就能正确输出构建时的FOO值：bar了。

方法2：用.env文件批量传递变量 #

如果有一堆变量要传，写一堆--build-arg太麻烦，就可以用.env文件：

1. 新建一个.env文件，把变量都写进去：

FOO=bar
BAZ=qux
APP_ENV=production

2. 在Dockerfile里声明对应的ARG：

ARG FOO
ARG BAZ
ARG APP_ENV
RUN echo "FOO: $FOO, BAZ: $BAZ, 环境: $APP_ENV"

3. 构建时用--env-file加载这个文件：

docker build --env-file .env .

这种方式批量管理变量更方便，也不容易漏传。

另外提个小细节：ARG变量只在构建过程中有效，如果想让变量在容器运行起来之后也能访问，得配合ENV指令把ARG的值转成环境变量：

ARG FOO
# 把构建参数赋值给容器环境变量
ENV FOO=$FOO

这样容器启动后，你进去跑echo $FOO也能拿到bar啦。

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