run指令优化核心是前置稳定操作、后置易变操作以最大化层缓存复用：先copy依赖文件并安装，再copy源码，合并同类命令清理临时文件，并配合.dockerignore剔除干扰项。
在 Dockerfile 中，RUN 指令的执行效率和镜像构建速度，高度依赖于**指令顺序与缓存复用逻辑**。优化高频变动指令的位置，核心目标是：**让稳定、低频变更的步骤尽可能靠前，把易变、常改的部分尽量往后放，从而最大化利用 Docker 的层缓存（layer cache）**。
把不变的基础操作前置
Docker 构建时，从上到下逐层执行；只要某一层的指令（及其上下文）未变，该层及之前所有层的缓存均可复用。因此：
- 系统更新（如
apt-get update && apt-get install -y）应与后续安装的软件绑定在同一 RUN 中，避免拆成两行导致缓存失效 - 创建目录、设置非敏感环境变量（如
WORKDIR、ENV PATH=...）这类几乎不改的操作，放在早期 RUN 或独立指令中 - 下载并校验固定版本的二进制（如 curl + sha256sum）比用 git clone 或 latest 标签更利于缓存
把易变内容尽量后置
所谓“高频变动指令”，常见于：
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 复制源码（
COPY . /app）—— 每次代码提交都会触发缓存失效 - 安装项目依赖（如
pip install -r requirements.txt）—— 依赖文件稍有增删即重建 - 编译构建命令（如
make build、npm install）—— 受源码和配置双重影响
正确做法是：先单独 COPY requirements.txt /tmp/，再 RUN pip install -r /tmp/requirements.txt，最后才 COPY . .。这样，只要依赖没变，安装依赖这层就永远复用，无需重装全部包。
合并多个 RUN 减少层数，但别牺牲可读性与缓存粒度
过多 RUN 会增加镜像层数，也可能因中间状态残留（如临时文件、缓存）增大体积；但盲目合并也会降低缓存效率：
- 反例：
RUN apt-get update && apt-get install ... && rm -rf /var/lib/apt/lists/* && pip install ... && make build—— 任一环节改，整层全重来 - 推荐分组：系统工具一组、语言依赖一组、应用构建一组，每组内清理干净（如清 apt 缓存、pip 缓存），既控体积又保缓存边界清晰
利用 .dockerignore 配合 RUN 更精准控制变更面
.dockerignore 不直接影响 RUN 执行，但它决定了 COPY 和 ADD 传入的内容。若忽略掉 node_modules/、__pycache__/、日志、本地配置等无关文件，就能避免这些干扰项意外触发后续 RUN 的缓存失效，间接提升 RUN 指令的稳定性。
