.dockerignore文件仅控制构建上下文上传内容，不改变镜像本身；需置于根目录，按规范排除node_modules/、.git/、*.log等三类冗余文件，配合多阶段构建与RUN内清理才能彻底优化体积与速度。

.dockerignore 文件不改变镜像内容，只控制构建上下文里哪些文件传给 Docker 守护进程。被忽略的文件根本不会上传，自然不参与缓存计算、不拖慢传输、也不会意外混入镜像——这是减小体积最前置、最轻量的手段。

重点排除三类高频冗余文件

这些文件体积大、变化频繁、且与最终运行完全无关：

• 本地依赖目录：如 node_modules/（Node.js）、venv/ 或 __pycache__/（Python）、target/（Java）。它们动辄几百 MB，但镜像中应由 RUN npm install 等命令在容器内安装，确保环境纯净。
• 日志与临时产出：如 logs/、*.log、tmp/、dist/（前端构建产物）。这类文件不仅占空间，还因内容常变导致构建缓存频繁失效。
• 开发与系统元数据：如 .git/、.env、.env.local、.vscode/、.DS_Store。Git 历史可能几十 MB；环境变量文件含密钥，有泄露风险；编辑器配置纯属本地，毫无必要。

规则写法和存放位置要规范

语法和 .gitignore 完全一致，但必须放在构建上下文根目录（通常就是 Dockerfile 所在目录），否则无效：

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• 每行一条规则，支持通配符（*）、递归匹配（**）和取反（!）；
• 路径以构建上下文为基准，不支持绝对路径或 ../ 向上跳转；
• 常见有效写法示例：
  

  node_modules/<br>.git/<br>logs/**<br>*.log<br>.env*<br>.vscode/<br>.DS_Store

验证是否真正生效

光写规则不够，得确认效果：

• 执行 docker build --no-cache -q . 后看输出的上下文压缩包大小，对比加 .dockerignore 前后差异；
• 用 docker history <image> 查看各层体积，若某层异常大，再结合 dive <image> 进入镜像检查是否有 logs/ 或 .git/ 残留；
• 注意：即使 Dockerfile 里没 COPY 这些文件，只要它们在上下文中，仍会上传并影响缓存命中率。

配合其他优化才更彻底

.dockerignore 解决的是“上传什么”，但镜像体积还受构建过程影响：

• 搭配 多阶段构建，把编译工具、源码、测试文件等彻底隔离在 builder 阶段；
• 在 RUN 中合并清理操作，比如 RUN apt-get update && apt-get install -y curl && apt-get clean && rm -rf /var/lib/apt/lists/*，避免残留层；
• 最终阶段主动裁剪 /var/log/、/tmp/ 和调试工具，尤其在 Alpine 镜像中可加 apk --no-cache 参数。