首页/云/Docker 容器速查/COPY 复制文件进镜像
镜像与构建107 条

COPY 复制文件进镜像

从构建上下文把文件/目录复制进镜像:不自动解压、不支持远程 URL,是复制内容的首选指令。

Docker 容器速查云更新于 2026-10-12
用途上下文 → 镜像复制
语法COPY 源... 目标
路径基准构建上下文根目录(非 Dockerfile 所在目录)

示例

示例
COPY package.json package-lock.json ./
COPY src/ /app/src/
COPY --from=build /out/app /usr/local/bin/app
多个源必须写目录目标;目标路径以 / 结尾按目录语义处理,否则按文件/重命名语义处理。

易错点

  • COPY ../xxx 会失败:源路径不能跳出构建上下文,需要更宽的上下文或调整目录结构
  • COPY 到不存在的目标目录时按文件处理,可能得到意料之外的文件名;目录复制语义与 cp 类似

数据来源与参考

  • Docker 官方文档:Dockerfile COPY(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌