首页/云/云与容器速查/docker build 参数组合(--build-arg/--target/--no-cache)
本包目录(340 条)
云基础概念44 条计算与存储56 条网络与安全组33 条
容器与 Docker106 条
Kubernetes68 条容器排障33 条

docker build 参数组合(--build-arg/--target/--no-cache)

构建命令的常用参数组合:改构建参数、只构建中间阶段、强制重建、多 Dockerfile 场景与目标平台,配合 buildx 还能出多架构镜像。

云与容器速查云更新于 2026-10-12
--build-arg向 Dockerfile ARG 传值,可多次出现
--target只构建到指定阶段(调 SDK 环境失败时定位中间层)
--no-cache忽略缓存全量重建(怀疑缓存污染时)
-f指定其他 Dockerfile 文件(默认上下文根 Dockerfile)
--platform指定目标平台,多架构需 buildx

典型组合

典型组合
docker build \
  --build-arg NPM_REGISTRY=https://registry.npmmirror.com \
  --target build \
  --no-cache \
  -t app:dev \
  -f docker/Dockerfile .
上下文是命令最后一个参数(通常 .);-f 指定的 Dockerfile 不必在上下文根,但只能引用上下文内的文件。

易错点

  • 改了构建参数却看旧结果:缓存命中,需要 --no-cache 或改命令行文本
  • -f 指到上下文外的 Dockerfile:COPY 失败,因为上下文不包含它

数据来源与参考

  • Docker Docs:docker build
  • Docker Docs:docker buildx build

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌