首页/云/云与容器速查/Dockerfile WORKDIR 工作目录
本包目录(340 条)
云基础概念44 条计算与存储56 条网络与安全组33 条
容器与 Docker106 条
Kubernetes68 条容器排障33 条

Dockerfile WORKDIR 工作目录

设置后续 RUN、CMD、ENTRYPOINT、COPY、ADD 的工作目录,不存在会自动创建。它同时决定容器运行时的默认 cwd,影响相对路径配置的解析。

云与容器速查云更新于 2026-10-12
作用为后续指令与运行进程设定工作目录
自动创建目录不存在时自动创建(即使后续没用到)
相对路径相对上一个 WORKDIR 叠加;建议一律写绝对路径
与 RUN cdRUN cd 只影响当前层,不能替代 WORKDIR

标准写法

标准写法
WORKDIR /app
COPY . .
RUN npm ci --omit=dev
CMD ["node", "server.js"]
应用读相对路径配置文件时,WORKDIR 就是查找起点;容器里报 no such file 先检查 cwd。

易错点

  • 用 RUN cd /app && … 代替 WORKDIR:下一层又回到根目录
  • 多层 WORKDIR 写相对路径:路径逐层叠加,最后到达的位置与直觉不符

数据来源与参考

  • Docker Docs:Dockerfile reference(WORKDIR)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌