COPY指令的核心作用是构建时将宿主机文件或目录按路径映射复制到镜像指定位置，适用于多阶段构建中定向提取中间产物、结合.dockerignore控制输入范围、通过ARG实现条件化提取等场景。
COPY指令的核心作用与适用场景
COPY 是 Docker 构建阶段最常用的文件复制指令，它在构建镜像时将宿主机上的文件或目录按路径映射方式复制到镜像的指定位置。它不执行任何解包、解析或远程拉取操作，仅做静态路径拷贝，因此轻量、可控、可复现——这使其成为“构建产物定向提取”的理想载体。
分阶段构建中用COPY提取中间产物
多阶段构建（multi-stage build）是实现定向提取的关键模式。典型做法是：前一构建阶段完成编译/打包，后一阶段只保留运行时所需产物，通过 COPY --from= 从指定构建阶段精准拉取目标文件。
- 确保前一阶段有明确的 stage name，例如
FROM golang:1.22 AS builder - 在最终阶段使用
COPY --from=builder /app/dist/app /usr/local/bin/app，只提取编译后的二进制文件 - 支持通配符和多个源路径，如
COPY --from=builder /src/out/*.so /lib/可批量提取动态库 - 注意路径必须是构建上下文中存在的真实路径；若源路径不存在，构建会失败，不会静默跳过
利用构建上下文与.dockerignore精准控制输入范围
COPY 总是从构建上下文（build context）中读取文件，而非本地任意路径。要实现“定向提取”，需提前清理无关内容，避免误拷或体积膨胀。
- 在项目根目录下配置 .dockerignore，排除
node_modules/、src/、tests/、.git/等非产物目录 - 将构建产物集中输出到独立子目录（如
dist/或target/），再用COPY dist/ /app/一次性提取 - 避免使用
COPY . /app这类宽泛指令，否则会引入大量冗余文件，破坏“定向”本意
结合构建参数实现条件化提取
通过 ARG 声明变量，可在构建时动态指定产物路径或名称，让 COPY 指令更灵活适配不同环境或发布形态。
- 在 Dockerfile 中声明：
ARG BUILD_OUTPUT=dist，然后写COPY ${BUILD_OUTPUT}/ /app/ - 构建时传参：
docker build --build-arg BUILD_OUTPUT=target/release . - 可用于区分 dev/test/prod 产物目录，或适配不同架构编译结果（如
arm64-bin/vsamd64-bin/）
常见陷阱与验证建议
定向提取看似简单，但容易因路径错位、阶段名拼写错误或忽略构建上下文限制而失败。
- 检查 COPY 源路径是否存在于对应 stage 的文件系统中：可用
RUN ls -la /path/in/stage辅助调试 - 不要混淆 COPY 和 ADD：ADD 会自动解压 tar 包并支持 URL，但语义不明确，不符合“定向提取”的确定性要求
- 构建后用
docker run --rm <image> ls -la /app快速验证产物是否准确落位 - 对敏感产物（如密钥、配置模板），应在构建前生成并纳入上下文，或改用 docker build --secret 配合挂载，而非硬编码进 COPY
