docker多阶段构建本身不直接实现开发到生产无缝衔接，它解决镜像体积优化与构建环境隔离；真正支撑该目标的是其与docker compose多文件架构、构建参数及ci/cd流水线的协同配合。
docker 多阶段构建本身不直接实现“开发到生产无缝衔接”，它解决的是镜像体积优化与构建环境隔离；真正支撑开发到生产无缝衔接的，是它与 docker compose 多文件架构 + 构建参数（--build-arg）+ ci/cd 流水线 的协同配合。关键在于分层解耦、按需注入、统一源头。
下面从三个实操维度讲清楚怎么落地：
多阶段构建中用 ARG 动态区分环境行为
在 Dockerfile 里声明构建时可变参数，让同一份代码在不同阶段生成不同行为的镜像：
-
ARG BUILD_ENV=dev控制编译选项或配置加载逻辑 -
ARG APP_VERSION统一标记镜像版本，避免人工打标出错 -
ARG NODE_ENV或SPRING_PROFILES_ACTIVE可直接透传给应用启动时读取
示例片段：
ARG BUILD_ENV=dev FROM node:18 AS builder WORKDIR /app COPY package*.json . RUN npm ci --only=production COPY . . RUN if [ "$BUILD_ENV" = "prod" ]; then npm run build:prod; else npm run build:dev; fi FROM nginx:alpine COPY --from=builder /app/dist /usr/share/nginx/html ENV NGINX_ENV=$BUILD_ENV
构建命令按环境传参：
# 开发环境构建（带 sourcemap、调试日志） docker build --build-arg BUILD_ENV=dev -t myapp:dev . # 生产环境构建（压缩、移除调试信息） docker build --build-arg BUILD_ENV=prod -t myapp:1.2.0 .
Compose 多文件合并 + 构建参数联动
docker-compose.yml 定义通用服务结构，docker-compose.prod.yml 覆盖构建参数和运行时配置，做到“一份定义，多处生效”：
docker-compose.yml（基础）：
services:
web:
build:
context: .
dockerfile: Dockerfile
image: myapp:latest
docker-compose.prod.yml（生产特化）：
services:
web:
build:
args:
- BUILD_ENV=prod
- APP_VERSION=1.2.0
environment:
- NODE_ENV=production
deploy:
resources:
limits:
memory: 512M
启动命令即生效：
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
此时 Compose 会把 BUILD_ENV=prod 作为构建参数传给 Docker Build，最终生成的镜像是纯生产版，且运行时配置也已就位。
CI/CD 流水线中固化构建逻辑
在 GitLab CI、GitHub Actions 等平台中，将上述逻辑封装为可复用的流水线模板：
- 检测分支（如
main→ prod，develop→ dev）自动选择BUILD_ENV - 提取 Git Tag 或语义化版本号作为
APP_VERSION - 构建完成后推送到私有镜像仓库，并触发对应环境的 Compose 部署任务
这样，开发者只需 git push，后续构建、镜像推送、环境部署全自动完成，无需手动切配置、改参数、重打包。
不复杂但容易忽略
