Dockerfile中CMD命令无法使用ARG路径变量的问题咨询

核心原因 #

ARG是构建阶段变量，仅在镜像构建过程中有效；而CMD是容器启动时执行的命令，属于运行阶段，此时ARG变量已不存在。另外你使用的是CMD的exec形式（JSON数组），Docker不会自动解析其中的环境变量，必须通过shell来处理变量展开逻辑。

两种正确解决方法 #

方法1：将ARG转为ENV环境变量

把构建时的ARG变量赋值给ENV，ENV变量会保留到容器运行阶段，shell就能正常解析：

ARG WORK_DIR=/home/myuser/work
# 将ARG变量转为ENV，使其在运行时可用
ENV WORK_DIR=$WORK_DIR

COPY ./code $WORK_DIR/code
# 让sh -c来解析环境变量
CMD ["sh", "-c", "$WORK_DIR/start.sh"]

方法2：构建时直接替换CMD中的变量

如果不需要在运行时修改路径，可在构建阶段让Docker直接替换CMD里的${WORK_DIR}，此时要把CMD写成shell形式（不用JSON数组）：

ARG WORK_DIR=/home/myuser/work

COPY ./code $WORK_DIR/code
# shell形式的CMD，构建时Docker会直接替换ARG变量
CMD $WORK_DIR/start.sh

额外说明 #

• 若坚持用exec形式但不想用ENV，也可以直接写死路径，但会失去变量的灵活性。
• 注意shell引号规则：sh -c的字符串里用$WORK_DIR即可（${WORK_DIR}也支持但没必要），且JSON数组内的字符串必须用双引号，确保shell能识别变量。

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