Docker基础教程（112）Dockerfile指令之设置构建变量的ARG命令：ARG命令：让Docker镜像变身“百变星君”，打造千人千面的构建魔法！

一、 引言：从“一砖一瓦”到“模组化施工”的飞跃

想象一下，你是一位才华横溢的“镜像建筑师”。最初，你手拿Dockerfile这张“施工蓝图”，一砖一瓦（一行一行的RUN，COPY）地辛勤构建着你的应用镜像。一切都很好，直到你需要为测试环境、生产环境、以及不同的功能特性构建略微不同的镜像。

你发现，你开始在蓝图旁堆放着一堆备注：“此处若为测试环境，请用test.db”、“此处若为生产环境，版本号请写v1.0.0”。很快，蓝图变得混乱不堪，维护多份几乎相同的蓝图更是让人头疼欲裂。

此刻，你需要一位“魔法顾问”——ARG指令。它不像RUN那样实干，不像COPY那样忙碌，但它却能给你的构建过程注入“灵魂”，让你的Dockerfile从一份静态的说明书，变成一份可配置的动态模板。它，就是打造“千人千面”镜像的密钥。

二、 ARG指令深度解剖：这位“魔法师”的底牌

1. 基础语法：简单到不可思议

它的语法简单得令人发指：

ARG <变量名>[=<默认值>]

• 变量名：就是你给这个魔法参数起的名字，比如VERSION, APP_ENV。
• 默认值（可选）：如果构建时不传入此参数，就会使用这个默认值。这是让构建保持灵活且不崩溃的安全网。

2. 作用域：它的“魔法”在哪里生效？

这是ARG最需要理解的“坑点”之一！它的魔法有作用域的限制。

• 规则一：定义后生效。一个ARG指令只在其定义之后的下一个FROM指令之前有效。
• 规则二：跨阶段？需重申！ 在多阶段构建（Multi-stage build）中，每个FROM指令都开启了一个新的构建阶段，也开启了一个新的作用域。如果你想在某个阶段使用一个ARG变量，必须在该阶段内重新声明它。

# 第一阶段
ARG VERSION=latest
FROM alpine:${VERSION} AS build-stage
# 这里，VERSION 是有效的