这个问题的核心其实是Docker的构建上下文限制——Docker守护进程只能访问你执行docker build时指定的上下文目录（默认是当前目录）里的文件，直接在Dockerfile里写COPY ../shared_files/ ...会报错，因为上下文外的文件对守护进程来说是不可见的。下面给你几个实用的解决方案，不用复制共用文件夹到每个项目：

方案1：以父目录作为构建上下文（最常用且推荐） #

先理清楚你的目录结构，假设是这样的：

parent_dir/
├─ shared_files/       # 所有项目共用的文件夹
│  ├─ common_lib/
│  └─ configs/
├─ project_a/
│  └─ Dockerfile
└─ project_b/
   └─ Dockerfile

别在project_a或project_b目录下执行构建，而是切换到parent_dir目录，用-f参数指定具体项目的Dockerfile路径：

# 构建project_a的镜像
docker build -t my-project-a -f project_a/Dockerfile .

# 构建project_b的镜像
docker build -t my-project-b -f project_b/Dockerfile .

这时候，你的Dockerfile里就可以直接用相对于父目录的路径来COPY共用文件了，比如project_a/Dockerfile里写：

# 把共用的库文件复制到镜像的/app/lib目录
COPY shared_files/common_lib/ /app/lib/
# 复制对应项目的配置文件
COPY shared_files/configs/app_a.conf /app/config/

这个方案简单直接，完全符合Docker的设计逻辑，是官方推荐的跨项目共享文件的方式。

方案2：用BuildKit挂载外部目录（适合不想切换构建目录的场景） #

如果因为某些原因你不想切换到父目录构建，可以开启Docker的BuildKit特性，在构建时直接挂载外部的共用文件夹。

首先确保你的Docker版本在18.09以上（大部分现代版本都满足），构建前先设置环境变量开启BuildKit：

export DOCKER_BUILDKIT=1

然后在项目的Dockerfile里用--mount指令把主机上的共用文件夹挂载到构建容器的临时目录，再复制到镜像里。比如project_a/Dockerfile里可以这么写：

# 挂载主机上的../shared_files到构建容器的/tmp/shared，然后复制到目标路径
RUN --mount=type=bind,source=../shared_files,target=/tmp/shared \
    cp -r /tmp/shared/common_lib/ /app/lib/ && \
    cp /tmp/shared/configs/app_a.conf /app/config/

这个方案的好处是可以保持在项目目录下构建，不需要切换路径，但写法稍复杂，而且依赖BuildKit特性。

避坑提醒 #

• 绝对不要在Dockerfile里直接写COPY ../shared_files/ ...，这会触发Docker的错误，因为上下文外的文件无法被守护进程访问。
• 如果用CI/CD工具构建（比如GitHub Actions、GitLab CI），只需要把CI的工作目录设置到父目录，然后用-f指定Dockerfile路径即可，和本地构建逻辑完全一致。

内容的提问来源于stack exchange，提问作者Tuomas Toivonen