如何在docker-compose中通过挂载卷安装本地可编辑pip包

Dockerfile中的RUN指令运行在镜像构建阶段，而docker-compose配置的volumes挂载仅在容器启动运行阶段才会生效。构建阶段容器文件系统里根本不存在挂载进来的/relaton-py目录，pip找不到对应路径自然会报“不是有效可编辑依赖”的错误。你进入容器后手动执行命令能成功，就是因为此时容器已经完成启动，卷挂载流程已经走完，/relaton-py路径真实存在。

方案1：启动阶段安装本地依赖（改动最小、适配开发/生产双环境） #

不要在Dockerfile构建步骤中安装本地editable依赖，把这步挪到容器启动入口执行，等卷挂载完成后再安装，完全不影响生产环境的镜像构建逻辑：

1. 修改Dockerfile，删除构建阶段安装relaton-py的RUN行，保留生产环境依赖安装逻辑：

COPY requirements.txt /code/requirements.txt
WORKDIR /code
RUN ["pip", "install", "-r", "requirements.txt"]
# 复制项目代码
COPY . /code

2. 在Project1根目录新建启动入口脚本entrypoint.sh：

#!/bin/bash
# 仅本地开发环境安装本地editable依赖，生产环境自动跳过
if [ "$APP_ENV" = "dev" ]; then
    pip install -e /relaton-py
fi
# 执行原有容器启动命令
exec "$@"

3. 在Dockerfile中添加入口配置：

COPY entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/entrypoint.sh
ENTRYPOINT ["entrypoint.sh"]
# 替换为你实际的服务启动命令，比如CMD ["gunicorn", "app:app"]

4. 在docker-compose配置中添加开发环境标记：

services:
  web:
    build: .
    volumes:
      - .:/code
      - /Users/myuser/Dev/Projects/relaton-py:/relaton-py
    environment:
      - APP_ENV=dev

这种方式保留了editable安装的热更新特性，修改本地relaton-py代码后容器内会实时生效，不需要重新构建镜像；生产部署时不配置APP_ENV=dev变量、不挂载本地relaton-py目录，就会直接使用requirements.txt中公开发布的正式版本，不需要维护两套Dockerfile配置。

方案2：BuildKit构建时挂载本地目录（适合要求构建阶段完成依赖安装的场景） #

如果必须在镜像构建阶段就完成本地依赖安装，可以开启Docker BuildKit功能，使用构建时绑定挂载能力拿到本地relaton-py目录，不需要依赖运行时卷挂载：

1. 确认本地Docker已开启BuildKit（新版本Docker默认开启）
2. 修改Dockerfile中的依赖安装步骤：

COPY requirements.txt /code/requirements.txt
WORKDIR /code
# 构建时临时挂载本地relaton-py目录完成安装
RUN --mount=type=bind,source=/Users/myuser/Dev/Projects/relaton-py,target=/relaton-py \
    pip install -e /relaton-py
RUN ["pip", "install", "-r", "requirements.txt"]
COPY . /code

注意该方案构建出的镜像脱离本地环境后，editable安装的relaton-py会失效，因为editable安装本质是指向本地路径的链接，目录本身不会被打入镜像，仅适合纯本地开发场景使用，建议配合多阶段构建区分开发/生产镜像。

方案3：调整构建上下文直接复制依赖代码（不推荐开发场景使用） #

修改docker-compose的构建上下文配置，把relaton-py纳入构建范围，在构建阶段直接将依赖代码复制进镜像：

1. 修改docker-compose的build配置：

build:
  context: ../ # 构建上下文设为Project1和relaton-py共同的父目录Home
  dockerfile: Project1/Dockerfile

2. 修改Dockerfile中的路径配置：

COPY Project1/requirements.txt /code/requirements.txt
COPY relaton-py /relaton-py
WORKDIR /code
RUN pip install -e /relaton-py
RUN pip install -r requirements.txt
COPY Project1/ /code

该方案会把relaton-py代码直接打入镜像，每次修改relaton-py代码都需要重新构建镜像，失去editable安装热更新的优势，且构建出的镜像包含本地依赖代码，不适合生产环境推送使用。

内容的提问来源于stack exchange，提问作者Stefano Munarini