.dockerignore 是优化镜像构建最轻量、见效最快的方式，它不修改镜像内容或 dockerfile 逻辑，仅过滤构建上下文：排除 node_modules/、.git/、logs/、.env 等本地开发产物、运行时生成物和敏感配置，从而减小上传体积、加速构建、提升缓存命中率并防止信息泄露。
直接用 .dockerignore 排除非必要文件，是优化镜像体积最轻量、见效最快的方式。它不改变镜像内容，也不调整 dockerfile 逻辑，只控制“哪些文件传给 docker 守护进程”——被忽略的文件根本不会上传，自然不会拖慢构建、污染缓存或意外混入镜像。
重点排除三类干扰项
构建上下文里真正需要的，通常只有源码、配置模板和资源文件。其他大部分属于开发环境或运行时产物，应明确过滤：
-
本地依赖包：如
node_modules/（Node.js）、venv/或__pycache__/（Python），这些应在容器内通过RUN npm install或pip install安装，确保环境纯净且可复现 -
版本与编辑器文件：如
.git/、.gitignore、.vscode/、.idea/、.DS_Store，它们对运行毫无作用，还可能泄露项目结构或本地设置 -
敏感配置与临时产出：如
.env、.env.local、*.log、logs/、dist/、build/；尤其注意dist/和build/——若你用多阶段构建，前端/Java 编译产物应在容器内生成，而非从本地复制
写法细节决定是否真生效
规则看似简单，但几处容易踩坑：
- 路径以
/开头表示从构建上下文根目录匹配，比如/node_modules比node_modules更精准，避免误匹配子目录里的同名文件 - 支持跨层级匹配，例如
**/*.pyc可忽略所有嵌套目录下的 pyc 文件 - 用
!取反，适合“先忽略再恢复”的场景，比如*.js后加!src/index.js，保留入口文件 - 注释用
#，空行自动跳过；路径区分大小写，不支持正则，只认 glob 模式
验证它有没有起作用
别靠猜测，用实际数据确认：
- 执行
docker build --no-cache -t test .，看日志开头 “Sending build context to Docker daemon …” 后面的字节数——对比忽略前后，体积应明显下降（常见案例：从 1.2GB 降到 85MB） - 临时在
.dockerignore末尾加一行*，再构建；如果报错提示找不到Dockerfile或package.json，说明它确实在过滤上下文
配合多阶段构建效果更稳
即使用了多阶段构建，初始构建上下文仍受 .dockerignore 控制。比如前端项目中，dist/ 被忽略后，builder 阶段仍可通过 COPY . . 获取源码并执行 npm run build，最终只把干净的产物复制到运行阶段——既避免本地产物污染，又防止误传敏感配置。
