控制上下文大小是解决Docker构建慢的关键，需用.dockerignore排除无关文件、精确COPY所需内容，并结合多阶段构建隔离构建与运行环境。
构建上下文过大是 Docker 构建慢的常见原因，而 COPY 指令本身不直接“处理”上下文大小，但它会把构建上下文中的文件实际打包传入镜像层——所以控制上下文才是关键。
用 .dockerignore 精准排除无关文件
构建上下文默认是 docker build 命令指定路径下的**全部内容**（包括隐藏文件、日志、node_modules、.git 等）。只要这些文件出现在上下文中，即使没被 COPY 引用，也会被客户端打包上传，拖慢整个构建流程。
务必在项目根目录创建 .dockerignore，明确剔除：
-
node_modules/、venv/、target/等构建产物目录 -
.git/、.DS_Store、*.log、*.tmp - 大型测试数据、文档源码（如
docs/、test-data/） - 未被 COPY 引用的冗余配置或备份文件（如
config.dev.bak）
只 COPY 真正需要的文件和目录
避免使用宽泛路径，例如 COPY . /app —— 它会把整个上下文复制进镜像，既增大镜像体积，又因文件多导致校验和计算变慢、缓存更易失效。
推荐写法：
-
COPY package.json package-lock.json ./→ 先装依赖（缓存友好） -
COPY src/ ./src/→ 只复制源码，不带测试或工具链 -
COPY nginx.conf /etc/nginx/nginx.conf→ 单文件精确复制
这样不仅减小每层体积，还能让 COPY 校验更快，提升缓存命中率。
结合多阶段构建，隔离构建与运行上下文
如果构建过程需要大量工具链、源码、临时文件，但最终镜像只需二进制或精简资源，就该用多阶段构建。构建阶段可拥有完整上下文，运行阶段只从构建阶段 COPY --from=builder 拿最小必需集。
示例：
- 构建阶段：含
gcc、make、完整源码，编译生成/app/myserver - 运行阶段：基于
alpine，仅COPY --from=builder /app/myserver /usr/local/bin/
此时运行阶段的构建上下文可以为空目录，彻底规避上下文过大问题。
检查并压缩上下文传输开销
运行 docker build -f /dev/null . --no-cache（不执行构建，只上传上下文），观察上传耗时。若明显偏长，说明上下文确实臃肿。
辅助手段：
- 用
du -sh .查看当前目录大小，确认是否异常 - 用
find . -size +10M -type f | head -20快速定位大文件 - 对静态资源（如图片、视频）考虑改用构建后挂载或 CDN 加载，而非打入镜像
