问题回顾 #

你原本在Dockerfile里硬编码了Git分支来克隆项目：

RUN git clone -b 027-infra http://201.57.129.38/arbitrium/api.git

想要把分支名换成动态变量，但发现RUN指令里环境变量不生效；同时你用docker-compose管理3个服务，其中2个需要克隆不同仓库但切换到同一分支，没法用COPY指令绕开克隆操作。你已经尝试用ARG实现了需求，但疑惑为什么环境变量不行。

为什么环境变量（ENV）在构建阶段的RUN指令里不生效？ #

这里的关键是要区分Docker的构建阶段和容器运行阶段：

• ENV 定义的是容器启动后运行时的环境变量。如果是通过docker run -e或者docker-compose的environment字段传入的环境变量，这些值是在容器启动时才注入的，镜像构建过程中根本拿不到这些值。
• 而RUN指令是在镜像构建阶段执行的，所以你试图用运行时的环境变量去控制构建阶段的git克隆操作，自然不会生效。

正确解决方案：使用构建参数（ARG） #

你已经找到的ARG方案是完全正确的，它就是Docker为构建阶段传递外部参数设计的特性，具体用法可以再细化一下：

1. 在Dockerfile中声明构建参数，还可以设置默认值（可选）：

# 可选：给分支设置默认值，构建时不传递参数就用这个值
ARG GIT_BRANCH=main
RUN git clone -b ${GIT_BRANCH} http://201.57.129.38/arbitrium/web.git

2. 构建时传递参数：

• 直接用docker build命令：

docker build --build-arg GIT_BRANCH=027-infra .

• 用docker-compose管理多服务时，可以在每个服务的build块里配置args，让多个服务共享同一个分支参数：

services:
  api-service:
    build:
      context: ./api
      args:
        GIT_BRANCH: 027-infra
  web-service:
    build:
      context: ./web
      args:
        GIT_BRANCH: 027-infra

如果想更灵活，还可以从系统环境变量里读取值，这样不用每次写死：

services:
  api-service:
    build:
      context: ./api
      args:
        GIT_BRANCH: ${GIT_BRANCH}
  web-service:
    build:
      context: ./web
      args:
        GIT_BRANCH: ${GIT_BRANCH}

然后构建时只需指定一次变量：

GIT_BRANCH=027-infra docker-compose build

总结一下 #

• 构建阶段的操作（比如RUN git clone）必须用ARG传递外部变量，因为ENV是运行时变量，构建阶段无法获取外部传入的ENV值。
• ARG专门用于构建阶段的参数传递，完美匹配你需要动态指定Git分支的场景，也能在docker-compose里统一管理多个服务的分支参数。

内容的提问来源于stack exchange，提问作者Vini.g.fer