arg用于构建时传参，仅在docker build阶段有效且不存入镜像；env设置的变量则持久化到镜像中，构建和运行时均生效，两者可结合使用：arg接收输入，env导出为运行时变量。

RUN 指令本身不能直接注入构建时的动态时间戳或版本号，因为它在构建阶段执行的是 shell 命令，而 Docker 构建上下文不支持在 RUN 中直接调用运行时环境变量（如 $(date)）并让其结果被后续指令（如 LABEL 或 ENV）稳定捕获——除非你显式赋值并导出为构建参数或构建时环境变量。

用 ARG + ENV 组合实现构建时注入

Docker 官方推荐方式是通过 ARG 传入构建参数，再用 ENV 将其固化为镜像环境变量。时间戳和版本号都适合这种方式：

• 在 Dockerfile 开头声明参数：
  ARG BUILD_TIME
ARG VERSION
• 在需要的位置设置为环境变量：
  ENV BUILD_TIME=$BUILD_TIME
ENV VERSION=$VERSION
• 也可用于 LABEL 记录元信息：
  LABEL build.time=$BUILD_TIME version=$VERSION

构建命令示例：
docker build --build-arg BUILD_TIME="$(date -u +%Y-%m-%dT%H:%M:%SZ)" --build-arg VERSION=1.2.3 -t myapp .

在 RUN 中临时使用时间戳（仅限当前层）

如果只是想在某一层 RUN 命令中打印或生成带时间戳的文件（比如日志、构建标记），可直接调用 date：

Docker Container Cleaner

CLI工具，用于清理已停止的Docker容器、未使用的镜像、卷和网络，释放磁盘空间。

下载

• RUN echo "Built at $(date -u +%Y-%m-%d_%H:%M:%S)" > /app/build-info.txt
• RUN mkdir -p /app/releases/v${VERSION}/$(date +%Y%m%d)（需确保 VERSION 已通过 ARG 传入）

注意：这种写法只影响当前构建层，不会自动成为镜像的环境变量或元数据，也不可用于后续 RUN 指令中的变量展开（Docker 不支持跨层变量继承）。

配合 BuildKit 实现更可靠的构建时变量

启用 BuildKit 后，可以使用更清晰的语法和更强的缓存控制：

• 设置环境变量（BuildKit 支持在构建时解析）：
  # syntax=docker/dockerfile:1
ARG BUILD_TIME=${BUILD_TIME:-$(date -u +%Y-%m-%dT%H:%M:%SZ)}
ENV BUILD_TIME=$BUILD_TIME
• 需要先启用：
  export DOCKER_BUILDKIT=1
  再执行构建命令

这样即使未手动传参，也会自动填充默认时间戳，适合 CI 环境统一管理。

避免常见误区

以下做法不可靠或无效：

• RUN export BUILD_TIME=$(date) —— export 只在当前 RUN 的 shell 中生效，无法传递给下一层
• 在 Dockerfile 中写死 ENV BUILD_TIME=$(date) —— Docker 不解析 $()，会原样保存字符串
• 依赖容器启动时的 date —— 这属于运行时行为，不是构建时注入