快捷導(dǎo)航

docker之WORKDIR指令的使用及說明

更新時間：2025年07月19日 08:48:01 作者：hero.zhong

WORKDIR設(shè)置工作目錄,后續(xù)命令基于此路徑執(zhí)行,若目錄不存在則自動創(chuàng)建,RUN指令每層獨立,不繼承前層狀態(tài),需用WORKDIR確保文件路徑正確,避免因分層存儲導(dǎo)致的文件找不到錯誤

docker WORKDIR指令的使用

WORKDIR 指定工作目錄

格式為 WORKDIR <工作目錄路徑>。
使用 WORKDIR 指令可以來指定工作目錄（或者稱為當(dāng)前目錄），以后各層的當(dāng)前目錄就被改為指定的目錄，如該目錄不存在，WORKDIR 會幫你建立目錄。

#test
FROM ubuntu
MAINTAINER hello
RUN mkdir /mydir
RUN echo hello world > /mydir/test.txt
WORKDIR /mydir
CMD ["more" ,"test.txt"]

假設(shè)根據(jù)該dockerfile構(gòu)建的鏡像名為 myimage

1、運(yùn)行 docker run myimage 輸出 hello world

2、運(yùn)行 docker run myimage more test.txt 和上面輸出一致

可以看出，more的參數(shù)是 test.txt，但沒有指定路徑，卻能成功，說明當(dāng)前路徑就是上面WORKDIR指令設(shè)置的。

如果我們在上面的dockerfile中把WORKDIR指令去掉，創(chuàng)建的容器運(yùn)行會報文件不存在錯誤。

之前提到一些初學(xué)者常犯的錯誤是把 Dockerfile 等同于 Shell 腳本來書寫，這種錯誤的理解還可能會導(dǎo)致出現(xiàn)下面這樣的錯誤：

RUN cd /app
RUN echo "hello" > world.txt

如果將這個 Dockerfile 進(jìn)行構(gòu)建鏡像運(yùn)行后，會發(fā)現(xiàn)找不到 /app/world.txt 文件，或者其內(nèi)容不是 hello。原因其實很簡單，在 Shell 中，連續(xù)兩行是同一個進(jìn)程執(zhí)行環(huán)境，因此前一個命令修改的內(nèi)存狀態(tài)，會直接影響后一個命令；而在 Dockerfile 中，這兩行 RUN 命令的執(zhí)行環(huán)境根本不同，是兩個完全不同的容器。這就是對 Dockerfile 構(gòu)建分層存儲的概念不了解所導(dǎo)致的錯誤。

之前說過每一個 RUN 都是啟動一個容器、執(zhí)行命令、然后提交存儲層文件變更。第一層 RUN cd /app 的執(zhí)行僅僅是當(dāng)前進(jìn)程的工作目錄變更，一個內(nèi)存上的變化而已，其結(jié)果不會造成任何文件變更。而到第二層的時候，啟動的是一個全新的容器，跟第一層的容器更完全沒關(guān)系，自然不可能繼承前一層構(gòu)建過程中的內(nèi)存變化。

因此如果需要改變以后各層的工作目錄的位置，那么應(yīng)該使用 WORKDIR 指令。