为何docker build --build-arg无法传递本地环境变量？实操报错求解

核心问题出在sudo的环境变量隔离机制：

• 你在普通用户shell中执行export PYTHON_VERSION=3.11，这个变量仅存在于当前普通用户的环境上下文里。
• 当运行sudo docker build --build-arg PYTHON_VERSION .时，sudo会以root身份启动Docker进程，此时root的环境中并没有PYTHON_VERSION这个变量，Docker接收到的参数值为空，导致Dockerfile里的FROM python:${PYTHON_VERSION}被解析为FROM python:，这是无效的镜像引用格式，因此触发invalid reference format错误。
• 而sudo docker build --build-arg PYTHON_VERSION=$PYTHON_VERSION .能正常工作的原因是：$PYTHON_VERSION在普通用户的shell中就被替换成了3.11，完整的PYTHON_VERSION=3.11参数被传递给sudo启动的Docker，自然能正确构建。

至于官方文档里的示例，是基于不使用sudo的场景——直接用当前用户运行Docker，此时环境变量可以被Docker正常读取。如果要在sudo下实现类似效果，可以用sudo -E docker build --build-arg PYTHON_VERSION .，-E参数会让sudo保留当前用户的环境变量（需确保sudoers配置允许该操作）。

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