在项目根目录添加 .dockerignore 文件可精准排除 node_modules/、.git/、日志等无关大文件，显著缩短构建上传时间；需按规范书写规则并验证上下文大小与镜像内容。
直接在项目根目录放一个 .dockerignore 文件，就能让 docker build 只传真正需要的文件过去，大幅缩短上传时间和构建耗时。关键不是“忽略越多越好”，而是精准排除那些体积大、变化频繁、又跟镜像无关的文件。
明确哪些文件必须被过滤
构建上下文里混入这些内容，最拖慢速度也最容易引发问题：
-
依赖安装目录：如
node_modules/（Node.js）、venv/或__pycache__/（Python）、target/（Java），它们通常几百MB起步，且本地安装的包根本不会进最终镜像 -
日志与临时文件：
*.log、*.tmp、logs/、tmp/，这类文件不仅占空间，还常因内容变动导致构建缓存失效 -
版本控制元数据：
.git/、.gitignore，整套 Git 历史可能达几十MB，完全没必要上传 -
本地开发配置：
.env、.env.local、.docker-compose.dev.yml，既不该进镜像，也不该参与构建过程
写法要准，避免常见陷阱
规则看似简单，但几处细节直接影响效果：
- 路径以
/结尾表示只匹配目录（如dist/），不加斜杠则匹配同名文件和目录（如dist） - 通配符
**支持跨级匹配（如**/*.log可忽略所有子目录下的日志），但部分旧版 Docker 不支持，建议优先用*.log覆盖多数场景 - 注释用
#开头，空行会被忽略；规则按顺序生效，后写的!xxx可以取消前面的忽略（慎用） - 文件必须放在
Dockerfile所在目录下，Docker 不会向上查找父级的.dockerignore
按语言快速套用模板
不用从零写，根据项目类型选对应基础项再微调：
-
Node.js 项目：
node_modules/、npm-debug.log、.vscode/、coverage/、test/ -
Python 项目：
__pycache__/、*.pyc、.venv/、.pytest_cache/、dist/、build/ -
Java/Maven 项目：
target/、.idea/、*.iml、*.class - 通用必加项：
.git/、*.md、README.md、Dockerfile*（防止误复制其他 Dockerfile）
验证是否真的起作用
别只靠感觉，用两步确认效果：
- 执行
docker build --no-cache -q .（加-q只输出镜像 ID），再对比加.dockerignore前后的构建时间，差异明显说明生效 - 运行
docker build --progress=plain . | grep "Sending build context"，看日志中上传的上下文大小，优化后应从百MB级降到几十MB甚至更小 - 额外检查：构建成功后，进容器执行
ls -la，确认node_modules等被忽略的目录确实没出现在镜像里
