核心方法是用 .dockerignore 文件排除无关文件以减少构建上下文体积，配合 buildkit 实现按需加载，再通过精简 copy 路径和控制上下文目录进一步优化传输效率。
核心方法是让 Docker 只传输真正参与构建的文件，避免把 node_modules、.git、日志、构建产物等无关内容打包上传。这能直接减少网络传输量，尤其在 CI/CD 高频构建或带宽受限环境下效果显著。
用好 .dockerignore 文件
这是最直接、最有效的手段。该文件必须与 Dockerfile 同级，规则生效后，Docker CLI 在打包上下文前就会跳过匹配路径。
- 基础排除项建议写全：
# 依赖目录
node_modules
bower_components
# 构建产物
dist
build
out
# 日志与临时文件
*.log
npm-debug.log
.DS_Store
# 版本与配置
.git
.gitignore
.env
.env.local
.vscode
__pycache__ - 注意规则顺序：从上到下匹配，可用
!反向保留个别文件，例如!src/config.prod.json - 验证是否生效：执行
docker build --no-cache -t test .时观察日志开头的 “Sending build context to Docker daemon”，后面显示的大小就是实际上传体积
控制构建起点目录
Docker 默认以当前目录（.）为上下文根。如果项目结构复杂，可将 Dockerfile 移至更靠近必要文件的子目录，或显式指定更小的上下文路径。
- 例如源码在
./src，依赖定义在./package.json，可把 Dockerfile 放到项目根，并用.dockerignore过滤；也可把 Dockerfile 移到./src，再通过docker build -f src/Dockerfile -t app ./src指定上下文为./src - 避免使用
docker build -f ./Dockerfile .却把 Dockerfile 放在深层目录（如./infra/docker/Dockerfile），此时上下文仍是整个项目根目录
启用 BuildKit 获取按需加载能力
BuildKit 不再强制全量上传上下文，而是根据 Dockerfile 中实际 COPY 或 ADD 的路径，动态拉取所需文件（前提是宿主机支持且已启用）。
- 启用方式（任选其一）：
export DOCKER_BUILDKIT=1
docker build -t myapp .
或
DOCKER_BUILDKIT=1 docker build -t myapp . - 配合
.dockerignore效果更佳：即使未启用 BuildKit，忽略规则也起作用；启用后，它还能进一步跳过未被引用文件的扫描和预处理 - 注意：部分旧版 CI 环境（如某些 GitLab Runner 默认配置）可能未开启 BuildKit，需检查并显式启用
避免在构建中隐式引入大文件
有些操作看似不涉及上下文，实则会触发额外文件读取或网络请求，间接加重带宽负担。
- 不要在 Dockerfile 中用
RUN curl https://.../big-file.tar.gz | tar xz替代COPY——这虽不走上下文，但会增加镜像层体积和构建不确定性；应提前下载好，放入上下文并用.dockerignore控制是否上传 - 禁用
ADD自动解压远程 URL 功能（如ADD https://.../archive.zip /app），它会绕过上下文机制却引入不可控网络行为和安全风险 - 前端项目慎用
COPY . .，改用精确路径：COPY package.json .→RUN npm ci→COPY src/ src/
