Dockerfile中为类PATH变量追加路径且无警告的正确方法

针对Linux镜像场景，解决未定义变量触发警告的问题，有两种靠谱的方案：

方案一：用RUN命令交给shell处理 #

直接在RUN里借助shell的参数展开语法处理，Docker本身不会解析这个变量替换，自然不会抛出UndefinedVar警告：

# 让后续容器启动时生效（适合登录shell）
RUN echo 'export PATH1=${PATH1:-}:/new-path1' >> /etc/profile.d/custom-path.sh

# 如果要让构建阶段后续的RUN命令也能用到这个变量
RUN export PATH1=${PATH1:-}:/new-path1 && echo "PATH1=$PATH1" >> /etc/environment

${PATH1:-}的作用是：如果PATH1未定义，就用空字符串替代，这样追加后要么是existing-path:/new-path1，要么是:/new-path1，完全符合PATH类变量的格式要求。

方案二：用ARG+ENV组合赋值 #

先通过ARG定义带默认值的变量，再赋值给ENV，这样即使基础镜像里没有PATH1，也不会有未定义的问题：

ARG PATH1=""
ENV PATH1=$PATH1:/new-path1

如果构建时需要传入已有的PATH1值，直接用docker build --build-arg PATH1=your-existing-path .即可覆盖默认值。

为什么之前的ENV写法会报错？ #

Docker的ENV指令自身的变量替换逻辑，和shell的参数展开不是一回事——哪怕你写了${PATH1:-}，Docker在解析ENV时还是会检查变量是否存在，不存在就会触发UndefinedVar警告。而上面两种方案都是绕开Docker的变量检查，要么交给shell处理，要么用ARG提前给默认值。

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