Dockerfile支持动态参数重写的核心是使用ARG声明构建参数并配合--build-arg覆盖默认值，ARG需在FROM后声明、仅构建阶段生效，多阶段构建中各阶段须单独声明，敏感信息禁用ARG而应使用--secret或挂载。
要让 Dockerfile 支持动态参数重写，核心是用 BUILD ARG 声明构建时可变参数，并在构建命令中用 --build-arg 覆盖默认值。这比硬编码更灵活，适合多环境（如 dev/staging/prod）或不同依赖版本的场景。
定义可覆盖的构建参数
在 Dockerfile 开头用 ARG 声明变量，支持设置默认值。注意：ARG 必须在 FROM 之后、RUN 之前声明才生效（Docker 23.0+ 允许在 FROM 前声明，但兼容性起见建议放后面）。
-
ARG NODE_VERSION=18.17.0—— 指定 Node.js 版本，默认为 18.17.0 -
ARG APP_ENV=production—— 运行环境，默认 production -
ARG CONFIG_URL=https://config.example.com/config.json—— 外部配置地址，便于不同集群注入
这些参数可在后续 RUN、COPY 或 ENV 指令中引用，例如：RUN npm install --engine-strict --no-audit 可配合 ENV NODE_ENV=$APP_ENV 传递给应用。
在构建阶段安全使用参数
ARG 只在构建期存在，不会留在镜像里。若需运行时仍可用，得显式转成 ENV：
-
ENV NODE_ENV=$APP_ENV—— 把构建参数转为容器环境变量 -
COPY --chown=node:node config/$APP_ENV/ ./config/—— 利用参数选择配置目录 - 避免在 ARG 中传密钥（如 API_TOKEN），应改用
--secret或挂载方式，防止被docker history泄露
用 docker build 命令动态传参
构建时用 --build-arg 覆盖默认值，支持多次使用，顺序无关：
docker build --build-arg NODE_VERSION=20.10.0 --build-arg APP_ENV=staging -t myapp:staging .- 也可从文件加载：
docker build --build-arg-file .buildargs .（Docker 23.0+，文件格式为KEY=VALUE） - CI 场景中常结合变量注入，比如 GitHub Actions 中写：
--build-arg APP_ENV=${{ env.DEPLOY_ENV }}
验证参数是否生效
构建后快速检查参数是否正确注入：
- 运行临时容器并打印环境：
docker run --rm myapp:staging printenv | grep APP_ENV - 查看构建日志中 RUN 步骤是否用了预期值（如下载了指定 NODE_VERSION 的二进制）
- 用
docker inspect查 ENV 字段确认是否已转为环境变量
不复杂但容易忽略：ARG 在多阶段构建中每个 stage 需单独声明，跨 stage 不自动继承。
