为何Docker构建中ARG值从3.12变为3.12.8？能否禁用该变化？

原因解析 #

1. 模糊版本标签的镜像映射逻辑
   你定义的ARG PYTHON_VERSION=3.12属于模糊版本标签，Docker Hub官方Python镜像会自动将这类大版本标签映射到该分支下的最新稳定补丁版本（当前3.12分支的最新版为3.12.8），因此实际拉取到的基础镜像是python:3.12.8-slim。
2. 构建阶段的变量覆盖规则
   FROM指令会启动全新的构建阶段，原构建阶段定义的ARG变量会被新基础镜像自带的环境变量覆盖——官方Python镜像内部本身就存在PYTHON_VERSION环境变量，其值为镜像对应的精确补丁版本（3.12.8），后续RUN echo $PYTHON_VERSION读取的是这个基础镜像的环境变量，而非你最初定义的ARG值。

禁用该变化的方法 #

有两种可行方案：

• 方案一：显式指定精确版本号
  直接将ARG默认值设为完整补丁版本，确保拉取指定版本镜像，后续输出的也会是该精确值：

  ARG PYTHON_VERSION=3.12.0
  FROM python:$PYTHON_VERSION-slim
  RUN echo $PYTHON_VERSION
  

• 方案二：重新声明ARG锁定原值
  在FROM指令后重新声明ARG，继承初始构建阶段的ARG值，覆盖基础镜像的环境变量：

  ARG PYTHON_VERSION=3.12
  FROM python:$PYTHON_VERSION-slim
  ARG PYTHON_VERSION  # 重新声明，继承初始ARG的3.12
  RUN echo $PYTHON_VERSION
  

内容的提问来源于stack exchange，提问作者raphaelauv