首页/云/Docker 容器速查/COPY 源与目标的路径语义
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

COPY 源与目标的路径语义

源按构建上下文解析,目标相对 WORKDIR;目录源复制的是内容,文件源到不存在的目标路径会被当作重命名。

Docker 容器速查云更新于 2026-10-12
源路径相对构建上下文根(不能 ../ 跳出)
目标路径绝对路径或相对 WORKDIR
目录语义复制目录内容而非目录本身

示例

示例
COPY config/app.yaml /etc/app/app.yaml   # 文件 → 文件
COPY config/ /etc/app/config/           # 目录内容 → 目标目录
COPY app.yaml /etc/app/                 # 文件 → 目标目录内
拿不准时先只 COPY 后 docker run 空跑,用 ls -R 确认布局,再补后续指令。

易错点

  • 文件复制到不存在目标时会被当成改名,目录层级不会自动创建,运行时报文件缺失
  • 工作目录未设置时相对目标以 / 为基准,写相对路径前先明确 WORKDIR

数据来源与参考

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