最稳妥的多环境动态配置方式是--build-arg传参+arg声明+env落地；arg仅构建期有效且须显式声明并设默认值，多阶段需各阶段重复声明，敏感信息禁用env落地。
用 --build-arg 传参 + ARG 声明 + ENV 落地，是实现多环境动态配置最稳妥的方式。关键不在“能不能传”，而在于“什么时候能用、怎么留到运行时”。
构建参数（ARG）必须显式声明才能生效
Docker 不允许未声明就使用的构建参数。从 Docker 18.09 开始，如果命令里写了 --build-arg KEY=VALUE，但 Dockerfile 中没有对应的 ARG KEY，构建会直接失败。
- 声明写在
FROM前或后都行，但作用域只覆盖当前阶段 - 多阶段构建中，每个
FROM后若需使用同名参数，必须重新写一遍ARG - 可设默认值，例如
ARG ENV=prod，不传参时自动回退
ARG 和 ENV 不是同一类东西，别混用
ARG 只活在构建过程中，镜像打好后就消失；ENV 会写进镜像层，容器启动后仍可用。
- 想控制构建行为（比如拉哪个 Git 分支、用哪个 Maven Profile），用
ARG - 想让应用运行时读到配置（比如 API 地址、数据库连接串），得靠
ENV - 常见做法：先
ARG API_URL，再ENV REACT_APP_API_URL=$API_URL，把构建期值转成运行期变量
典型多环境构建流程示例
以 Spring Boot + React 前后端一体项目为例：
- 前端构建阶段：
ARG NODE_ENV=production→RUN npm ci && npm run build→ 自动读取NODE_ENV打包不同配置 - 后端构建阶段：
ARG PROFILE=prod→RUN mvn clean package -Dspring.profiles.active=$PROFILE - 最终运行镜像：
ENV SPRING_PROFILES_ACTIVE=$PROFILE→ 容器启动时自动激活对应 profile - 构建命令：
docker build --build-arg PROFILE=staging --build-arg NODE_ENV=staging -t myapp:staging .
容易踩坑的几个细节
这些点看似小，但实际构建失败八成出在这儿：
- 空格和特殊字符没加引号：比如
--build-arg VERSION=1.2.3-beta没引起来，shell 会截断 - 多阶段中漏掉重复声明：第二阶段用了
$PROFILE却没写ARG PROFILE，值为空 - 误以为 ARG 能直接当环境变量用：容器里
echo $PROFILE是空的，除非你显式ENV PROFILE=$PROFILE - 敏感信息（如密钥）只用 ARG 传，不写进 ENV，避免残留到镜像里
