07_dockerfile/7.10_workdir.md
WORKDIR <工作目录路径>
WORKDIR 指定后续指令的工作目录。如果目录不存在,Docker 会自动创建。
WORKDIR /app
RUN pwd # 输出 /app
RUN echo "hello" > world.txt # 创建 /app/world.txt
COPY . . # 复制到 /app/
## ❌ 错误:cd 在下一个 RUN 中无效
RUN cd /app
RUN echo "hello" > world.txt # 文件在根目录!
RUN cd /app
↓
启动容器 → cd /app(仅内存变化)→ 提交镜像层 → 容器销毁
│
↓ 工作目录未改变!
RUN echo "hello" > world.txt
↓
启动新容器(工作目录在 /)→ 创建 /world.txt
每个 RUN 都在新容器中执行,前一个 RUN 的内存状态 (包括工作目录) 不会保留。
## ✅ 正确:使用 WORKDIR
WORKDIR /app
RUN echo "hello" > world.txt # 创建 /app/world.txt
WORKDIR 支持相对路径,基于上一个 WORKDIR:
WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd # 输出 /a/b/c
ENV APP_HOME=/app
WORKDIR $APP_HOME
RUN pwd # 输出 /app
## 构建阶段
## 建议使用 node:22 或 node: 等具体版本标签,避免使用 latest
FROM node:22 AS builder
WORKDIR /build
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build
## 生产阶段
## 建议使用 nginx:alpine 或其他具体版本
FROM nginx:alpine
WORKDIR /usr/share/nginx/html
COPY --from=builder /build/dist .
# 建议使用 node:22 等主/次版本号标签
FROM node:22
WORKDIR /app # 尽早设置
COPY package*.json ./
RUN npm install
COPY . .
CMD ["node", "server.js"]
## ✅ 推荐:绝对路径,意图明确
WORKDIR /app
## ⚠️ 避免:相对路径可能造成混淆
WORKDIR app
## ❌ 避免
RUN cd /app && echo "hello" > world.txt
## ✅ 推荐
WORKDIR /app
RUN echo "hello" > world.txt
WORKDIR /app
## ... 应用相关操作 ...
WORKDIR /data
## ... 数据相关操作 ...
...
| 指令 | WORKDIR 的影响 |
|---|---|
RUN | 在 WORKDIR 中执行命令 |
CMD | 在 WORKDIR 中启动 |
ENTRYPOINT | 在 WORKDIR 中启动 |
COPY | 相对目标路径基于 WORKDIR |
ADD | 相对目标路径基于 WORKDIR |
WORKDIR /app
RUN pwd # /app
COPY . . # 复制到 /app
CMD ["./start.sh"] # /app/start.sh
使用 -w 参数覆盖工作目录:
$ docker run -w /tmp myimage pwd
/tmp