Docker构建中断后如何跳过已完成的文件下载？

核心思路 #

Docker构建缓存基于分层机制，只要某一层的指令未发生变化，构建时会直接复用之前的结果。你之前将所有步骤塞进单个RUN指令，导致任意步骤失败后整个层都要重新执行。解决方法是拆分步骤+存在性判断，让下载压缩包的逻辑独立为可缓存的层，且仅在文件不存在时触发下载。

具体Dockerfile修改方案 #

1. 单独拆分下载步骤，添加存在性判断
   通过if [ ! -f 文件名 ]; then 下载命令; fi的逻辑，确保仅当压缩包不存在时才执行下载：

   # 仅当CoppeliaSim压缩包不存在时执行下载
   RUN if [ ! -f /opt/CoppeliaSim_Edu_V4_1_0_Ubuntu20_04.tar.xz ]; then \
           wget -q -O /opt/CoppeliaSim_Edu_V4_1_0_Ubuntu20_04.tar.xz "你的CoppeliaSim下载URL"; \
       fi
   

   其中-q参数让wget静默输出，避免构建日志冗余；路径可根据你的需求自行调整。

2. 独立执行解压步骤
   将解压操作单独放在一个RUN指令中，这样下载层被缓存后，解压步骤也会直接复用缓存：

   # 解压CoppeliaSim到目标目录
   RUN tar -xf /opt/CoppeliaSim_Edu_V4_1_0_Ubuntu20_04.tar.xz -C /opt/
   

3. 配置环境变量
   使用ENV指令持久化环境变量，这会生成独立的层，后续构建无需重复执行：

   ENV COPPELIASIM_ROOT=/opt/CoppeliaSim_Edu_V4_1_0_Ubuntu20_04
   ENV LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$COPPELIASIM_ROOT
   ENV QT_QPA_PLATFORM_PLUGIN_PATH=$COPPELIASIM_ROOT
   

4. 单独处理PyRep的克隆与安装
   将git克隆和安装步骤拆分出来，即使这一步构建失败，前面的下载、解压、环境变量配置层也不会失效：

   # 克隆PyRep仓库并完成安装
   RUN git clone https://github.com/stepjam/PyRep.git /opt/PyRep && \
       cd /opt/PyRep && \
       pip install -e .
   

方案有效性说明 #

• 下载步骤的RUN指令仅在压缩包不存在时执行，且只要指令本身未修改，Docker会复用之前的缓存层，不会重复下载。
• 拆分后的每个步骤都是独立层，即使PyRep克隆失败，重新构建时仅会重新执行克隆和安装步骤，前面的下载、解压、环境变量配置层会直接复用，大幅节省时间。

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