Docker多阶段构建如何为所有阶段全局设置WORKDIR？

首先明确Dockerfile的原生规则：不存在直接在所有FROM指令前声明一次WORKDIR就自动对所有构建阶段生效的语法。
Docker 中FROM是构建阶段的分隔标记，除了全局声明的ARG变量外，其余所有指令（包括WORKDIR、ENV、文件操作等）的作用域都会被FROM截断，不会自动跨阶段传递。每个新阶段启动时，工作目录默认会重置为当前引用基础镜像内置的WORKDIR配置，未配置的话默认是根目录/。

最优方案：把WORKDIR下沉到最底层基础镜像 #

如果你的所有构建阶段都派生自同一个自定义base镜像，直接在构建base镜像的时候就配置好WORKDIR，后续所有衍生阶段只要不主动修改工作目录，都会自动继承这个配置，完全不需要重复写。
示例：

1. 先构建你的自定义base镜像（Dockerfile片段）：

# base镜像的构建配置
FROM python:3.11-slim
# 提前定义好工作目录路径
ARG PYSETUP_PATH=/opt/pysetup
ENV PYSETUP_PATH=$PYSETUP_PATH
# 全局配置一次WORKDIR
WORKDIR $PYSETUP_PATH
# 其他base层通用配置，比如安装系统依赖、配置pip源等

2. 后续多阶段构建就可以省略所有重复的WORKDIR配置：

FROM base as builder
# 自动继承base里的WORKDIR，直接写构建逻辑即可

FROM builder as test
# 自动继承WORKDIR，直接写测试逻辑即可

FROM builder as deploy
# 自动继承WORKDIR，直接写部署逻辑即可

这个方案完全符合你“一次配置全局生效”的预期，也是生产环境最常用的做法。

次优方案：新增公共中间层统一配置 #

如果你不方便修改底层base镜像，可以在Dockerfile最开头加一个所有业务阶段都依赖的公共中间阶段，把WORKDIR和其他通用配置都放在这个中间层，后续所有阶段都从这个中间层派生即可。
示例：

# 全局声明路径变量，所有阶段都可以引用
ARG PYSETUP_PATH=/opt/pysetup

# 公共基础阶段，放所有阶段通用的配置
FROM base as common
# 引入全局ARG变量
ARG PYSETUP_PATH
# 只在这里配置一次WORKDIR
WORKDIR $PYSETUP_PATH
# 其他通用配置比如ENV、目录初始化等也可以放这里

# 后续所有业务阶段都从common派生，自动继承WORKDIR
FROM common as builder

FROM common as test

FROM common as deploy

注意：全局声明的ARG变量，在每个FROM之后的阶段内如果要使用，必须单独写一行ARG 变量名（不需要重新赋值）才能正常引用，这是Docker ARG的固定作用域规则。

为什么直接在FROM前写WORKDIR不生效 #

如果把WORKDIR写在第一个FROM之前，旧版本Docker会直接报语法错误，新版本Docker中这个配置也只会作用于第一个构建阶段，后续阶段完全不会继承这个配置，达不到全局生效的目的。

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