COPY指令的源路径始终相对于构建上下文根目录（即docker build命令末尾的“.”所指目录），而非Dockerfile所在位置；目标路径可为绝对路径或相对于WORKDIR的相对路径，且源路径不可超出上下文范围。
COPY 指令中的相对路径，是相对于构建上下文（build context）根目录的，不是 Dockerfile 所在目录，也不是容器内路径。
什么是构建上下文
执行 docker build -f Dockerfile . 时，最后那个点（.）代表构建上下文根目录。Docker 守护进程只“看到”这个目录及其子目录里的文件——其他位置的文件无法被 COPY 引用。
- 即使 Dockerfile 放在
./src/Dockerfile，只要构建命令在项目根目录运行（docker build -f src/Dockerfile .），上下文仍是. - COPY 的源路径必须在这个上下文内可访问，比如
COPY app.py /app/要求当前目录下有app.py - 不能写
COPY ../config.yaml /app/—— 因为../超出了上下文范围，会报错 “no such file or directory”
COPY 源路径怎么写才有效
源路径用的是 Unix 风格正斜杠，不区分大小写（Linux/macOS 下），且始终从构建上下文根开始算起：
-
COPY ./src/main.py /app/→ 复制上下文根下的src/main.py -
COPY assets/ /usr/share/assets/→ 复制整个assets/文件夹（注意末尾无斜杠表示目录） -
COPY .env ./config/→ 复制上下文根下的.env到镜像中/config/.env（目标路径是绝对路径，./config/等价于/config/） - 省略
./也可以：COPY src/ /app/src/和COPY ./src/ /app/src/效果一样
常见误区和避坑提示
容易出错的地方往往不在语法，而在路径理解偏差：
- Dockerfile 中
COPY ../lib/utils.py /app/❌ —— 构建上下文外的文件不可见，必须把需要的文件挪进上下文，或调整构建命令的上下文路径 - 误以为
COPY的“相对”是相对于 Dockerfile 位置 → 实际不是，Dockerfile 可以放在任意子目录，只要构建命令指定正确上下文 - Windows 用户注意：路径分隔符统一用
/，不要用\，否则可能被当作转义字符处理 - 如果要用不同位置的文件，推荐做法是：把构建所需文件集中到一个目录，再以该目录为上下文运行
docker build
验证路径是否有效的简单方法
在运行 docker build 前，先确认你要 COPY 的文件确实在上下文里：
- 执行
ls -R或tree查看当前目录结构 - 临时加一行
RUN ls -l /path/you/want/to/copy（仅用于调试）观察是否能列出来 - 用
docker build --progress=plain .查看详细日志，失败时会明确提示找不到哪个源文件
