如何不使用docker cp将Docker容器内编译文件自动拷贝到宿主机

Dockerfile中的COPY <source> <target>指令无法实现容器编译产物自动同步到宿主机的需求。

原因说明 #

COPY是Docker镜像构建阶段的单向操作，作用是将docker build命令指定的构建上下文（通常是你执行build命令所在的宿主机目录）中的文件，复制到待构建的镜像内部文件系统，传输方向固定为宿主机 → 镜像，既不支持反向从镜像/容器往宿主机传输文件，也没有能力在构建或运行流程结束后主动推送文件到宿主机。

可行落地方案 #

方案1：宿主机目录挂载（最推荐，适配绝大多数自动化构建场景） #

运行编译容器时，通过-v参数将宿主机的目标产物目录，直接挂载到容器内编译命令的输出路径，容器内编译生成的文件会直接写入宿主机对应目录，全程不需要手动执行拷贝操作。
命令示例：

# 参数说明：
# --rm 表示编译完成容器退出后自动删除容器实例，不留冗余垃圾
# 第一个-v挂载把宿主机源码目录挂到容器内源码路径，避免每次构建都要重新拷源码
# 第二个-v挂载把宿主机产物目录挂到容器内编译输出路径
docker run --rm \
  -v $(pwd)/src:/app/src \
  -v $(pwd)/dist:/app/build/output \
  你的预构建编译镜像名 \
  npm run build # 替换成你实际的编译命令，比如make、cmake、go build等

命令执行完成后，直接去宿主机的./dist目录取编译产物即可，整个流程可以直接写到shell脚本、Makefile或者CI流水线里，完全自动化。

方案2：多阶段构建配合buildx导出（适合把编译流程固化在Dockerfile里的场景） #

如果你希望把编译逻辑全部维护在Dockerfile中，不需要单独写运行脚本，可以用多阶段构建的能力，在构建阶段完成编译后，直接通过build命令的--output参数把指定阶段的产物导出到宿主机，不需要启动容器，也不需要手动cp。
示例Dockerfile：

# 第一阶段：用你提前做好的带全量构建工具的镜像完成编译
FROM your-custom-build-image:latest AS builder
WORKDIR /app
COPY ./src /app/src
RUN make build # 执行编译，产物默认输出到/app/build目录

执行构建导出命令：

# 执行后会把builder阶段中/app/build下的所有文件，直接导出到宿主机当前目录的dist文件夹
docker build --target builder --output type=local,dest=./dist .

方案3：编译后自动拷贝（适合编译过程不希望直接写宿主机磁盘的场景） #

如果编译过程会产生大量临时IO文件，不想直接把输出目录挂载到宿主机影响编译速度，可以只挂载一个用来接收最终产物的目录，容器启动后先在内部存储完成编译，再自动把最终产物拷贝到挂载的宿主机目录：

docker run --rm \
  -v $(pwd)/dist:/host_dist \
  your-custom-build-image:latest \
  sh -c "make build && cp -r /app/build/* /host_dist/"

内容的提问来源于stack exchange，提问作者Arnold Zahrneinder