Docker中ARG指令作用域疑问：文档说明与实际表现不符

为什么后续阶段无需重新声明ARG也能访问参数？ #

当使用FROM <前一阶段镜像>启动新的构建阶段时，前一阶段镜像的构建元数据会被自动继承到新阶段中，其中就包含已声明的ARG参数及其对应的值。这些ARG信息被存储在镜像的Config.Arguments字段中，可通过docker inspect <镜像ID>命令查看具体内容。

需要明确两种场景的继承逻辑：

• 若ARG是在前一阶段内部声明并赋值的，后续基于该阶段的新阶段会直接继承这个预定义的ARG值；
• 若ARG是通过--build-arg传入的全局构建参数，只要前一阶段已经声明过该ARG，后续基于该阶段的新阶段也会继承这个外部传入的值。

官方文档提到的“ARG在定义的构建阶段结束后失效”，其实是针对非基于前一阶段的全新构建阶段（比如直接从公共基础镜像如ubuntu:latest启动的阶段），这类场景下确实需要重新声明ARG才能访问参数值。

该表现是否属于实现细节，不可依赖？ #

是的，这种ARG自动继承的行为属于Docker的实现细节，绝对不建议依赖，理由如下：

• 官方文档并未将此列为正式支持的特性，仅明确要求在每个需要使用ARG的阶段显式重新声明；
• Docker版本迭代可能会调整元数据存储或继承逻辑，导致后续版本不再兼容该行为；
• 在特殊构建场景（如使用--no-cache跳过缓存、修改构建上下文、使用第三方构建工具）中，这种继承可能会意外失效；
• 依赖该行为会降低Dockerfile的可移植性，在不同环境或构建工具中可能出现不一致的构建结果。

遵循官方文档的规范，在每个需要使用ARG的构建阶段显式重新声明参数，才是保证构建稳定性和可移植性的正确做法。

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