多阶段构建中跨阶段文件复制必须显式指定绝对路径，源路径相对于源阶段WORKDIR，需命名阶段、避免相对路径陷阱，并注意隐藏文件与目录结构一致性。
多阶段构建中，跨阶段依赖传递的路径问题本质是“文件可见性”和“路径上下文隔离”问题。每个阶段有独立的文件系统，前一阶段生成的文件不会自动出现在后一阶段，必须显式复制，且路径需严格匹配源与目标环境。
明确源阶段路径，避免相对路径陷阱
复制时指定的源路径是相对于源阶段工作目录（WORKDIR）的绝对路径，不是构建上下文根目录。若未设 WORKDIR 或路径写错，COPY --from=stage_name 会失败或复制空内容。
- 第一阶段应显式声明
WORKDIR /app，再COPY . .和RUN go build -o /app/server，确保二进制落在/app/server - 第二阶段复制时写
COPY --from=builder /app/server /usr/local/bin/，不能写./server或server - 若源文件在子目录（如
/app/dist/static/），目标路径也要按需创建父目录：RUN mkdir -p /var/www/html && COPY --from=builder /app/dist/static /var/www/html
处理隐藏文件和目录结构一致性
默认 COPY 不包含以 . 开头的隐藏文件（如 .env、.config），而某些应用启动依赖它们。同时，源阶段的目录层级若与目标阶段不一致，会导致运行时路径错误。
- 需要隐藏文件时，单独复制：
COPY --from=builder /app/.env /app/.env - 推荐用通配符加排除法（Docker 20.10+ 支持）：
COPY --from=builder /app/{*,.env} /app/ - 若源阶段输出为
/build/output/app，但目标期望在/app下运行，可先RUN mkdir -p /app，再COPY --from=builder /build/output/app/. /app/（末尾/.表示复制内容而非目录本身）
用命名阶段 + 显式 AS 避免索引混淆
不使用 AS name 时，Docker 按 FROM 出现顺序编号（0、1、2…），一旦增删阶段，--from=1 可能指向错误阶段，导致路径复制错位。
- 所有阶段都应命名：
FROM golang:1.21 AS builder、FROM alpine:latest AS runtime - 复制时始终用名称引用：
COPY --from=builder /app/server /，不依赖数字索引 - CI/CD 中多人协作修改 Dockerfile 时，命名可读性强，降低路径误配风险
验证路径是否生效的实用方法
构建过程中无法直接查看中间阶段文件系统，但可通过临时调试阶段确认路径正确性。
- 在第二阶段开头加调试命令：
RUN ls -la /app && cat /app/version.txt 2>/dev/null || echo "file missing" - 用
docker build --target debug-stage .构建一个临时调试阶段，把前一阶段内容完整导出：FROM builder AS debug-stage && CMD ["sh", "-c", "find /app -type f"] - 本地测试时，用
docker create启动中间镜像并docker cp检查实际内容：docker cp $(docker create builder-image):/app/server ./server
