快捷導(dǎo)航

docker之WORKDIR指令的使用及說明

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

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

docker WORKDIR指令的使用

WORKDIR 指定工作目錄

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

#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è)置的。

如果我們?cè)谏厦娴膁ockerfile中把WORKDIR指令去掉，創(chuàng)建的容器運(yùn)行會(huì)報(bào)文件不存在錯(cuò)誤。

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

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

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

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

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