docker镜像构建中arg指令实现变量动态传递，核心是“定义+传入+使用”闭环：arg必须位于from之后、支持默认值（如arg version=1.2.0）、仅构建阶段有效且不存于最终镜像；构建时通过--build-arg覆盖默认值，多阶段需各阶段独立声明arg。
Docker 镜像构建通过 ARG 指令实现变量的动态传递，核心在于“定义 + 传入 + 使用”三步闭环。它不保存在最终镜像里，只在构建过程中生效，适合管理版本号、环境标识、编译选项等非敏感配置。
在 Dockerfile 中正确定义 ARG 及默认值
ARG 必须写在 FROM 之后（不能在最开头），支持直接赋默认值，让构建更健壮：
- 语法简洁：
ARG VERSION=1.2.0或ARG BUILD_DATE（无默认值，构建时必须传） - 多参数可分行定义，顺序无关，但作用域从定义行开始向后生效
- 若未设默认值又未传参，
docker build会报错，提示缺失参数
构建时用 --build-arg 覆盖或注入值
运行 docker build 时，用 --build-arg 显式传参，优先级高于默认值：
- 单个参数：
docker build --build-arg APP_ENV=staging -t myapp:staging . - 多个参数可重复使用该标志：
--build-arg NODE_ENV=production --build-arg COMMIT_SHA=abc123 - 值中含空格或特殊字符需加引号：
--build-arg DESCRIPTION="v2.1 release"
在构建阶段内安全使用 ARG 值
ARG 只在构建时存在，不能直接用于容器运行时。如需保留为运行环境变量，必须显式转给 ENV：
- 直接使用：
RUN echo "Building for $APP_ENV" - 转为环境变量：
ENV NODE_ENV=$APP_ENV（此时NODE_ENV会保留在镜像中） - 避免误用：
ARG不能用于FROM行之前的任何地方，也不能在COPY源路径中直接插值（Docker 不支持）
多阶段构建中注意 ARG 作用域隔离
每个 FROM 开启新构建阶段，ARG 不自动跨阶段继承：
- 每个阶段需独立声明所需
ARG，即使名字相同也要重写 - 常见做法：在第一阶段定义通用参数，后续阶段按需重新声明并使用
- 示例：
ARG DISTRO=alpine在第一个FROM $DISTRO:latest中生效；第二个阶段若要用，得再写一遍ARG DISTRO
