Docker容器中pip install -e安装Python包后无法导入问题

问题核心原因 #

你猜的没错，就是Docker卷挂载的覆盖行为导致的：

• 构建镜像时，RUN pip install -e .会在容器内的/usr/src/app目录下创建软链接，指向当前目录的包源码，让Python能识别到这个可编辑安装的包。
• 但启动容器时，volumes配置把本地./services/myapp/挂载到了容器的/usr/src/app/，直接覆盖了容器内原有的目录结构——包括pip刚创建的软链接。此时Python找不到包，因为原来的链接指向的路径已经被本地挂载内容替换，链接关系失效了。
• 手动进容器重新执行pip install -e .，是基于当前挂载后的本地目录重新创建软链接，自然就能正常识别包了。

可行解决方案 #

方案1：把可编辑安装放到容器启动阶段（推荐）

修改entrypoint.sh，在启动应用前先执行pip install -e .，确保每次容器启动都基于挂载后的最新目录生成有效链接：

#!/bin/sh
# 先执行可编辑安装，适配挂载后的目录
pip install -e .
# 再启动你的应用
python manage.py runserver 0.0.0.0:5000

同时把Dockerfile里的RUN pip install -e .删掉，避免构建时做无用功。

方案2：仅在需要时手动执行可编辑安装

保持Dockerfile里用pip install .完成常规安装，开发调试时再进入容器执行pip install -e .。缺点是每次重新构建镜像后都需要重复操作，适合临时调试场景。

方案3：调整挂载路径（依赖项目结构）

如果你的包源码集中在某个子目录（比如./services/myapp/my_package/），可以只挂载这个子目录，而不是整个/usr/src/app/：

volumes:
  - ./services/myapp/my_package/:/usr/src/app/my_package/

这样构建时创建的软链接不会被完全覆盖，Python依然能识别到包。但这种方式需要项目结构支持，通用性不如方案1。

验证方法 #

进入容器后执行：

pip show <你的包名>

查看Location字段：

• 挂载后未重新安装时，这个路径指向的是容器内原目录的软链接，实际已被覆盖失效；
• 重新执行pip install -e .后，Location会指向挂载后的本地目录路径，此时链接有效。

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