Dockerfile安装本地Python包失效：无需虚拟环境的解决方法探究

为什么虚拟环境能解决问题？ #

首先，你的核心问题是系统中多Python版本导致的pip与Python版本不匹配：

• 你通过deadsnakes源安装了Python3.9，但Ubuntu 20.04默认的python3-pip是绑定到系统自带的Python3.8的。
• 当你运行pip3 install -e ./mypackage时，这个pip3实际上是给Python3.8安装包，而容器里你用的是Python3.9，自然找不到这个包。
• 虚拟环境的作用是创建独立的Python运行环境：
  • 它会把python和pip都指向你指定的Python3.9版本，彻底隔离了系统的Python3.8环境。
  • 所有依赖安装都会进入这个虚拟环境的site-packages目录，确保你运行的Python3.9能找到对应的包。
  • 另外，虚拟环境也能让依赖环境更干净，避免不同项目的依赖互相干扰（虽然容器本身已是隔离环境，但多一层隔离更稳妥）。

无需虚拟环境的解决方法 #

要在不使用虚拟环境的情况下让Python3.9识别你的包，关键是确保安装包时用的是Python3.9对应的pip，而非系统默认的pip3。可以通过以下两种方式修复：

方法1：直接用Python3.9的pip模块安装 #

修改Dockerfile中的安装命令，用python3.9 -m pip代替pip3：

# install mypackage
RUN python3.9 -m pip install -e ./mypackage

这样会明确调用Python3.9自带的pip工具，把包安装到Python3.9的site-packages目录下，Python3.9运行时就能正常识别。

方法2：修复pip3的软链指向 #

如果希望继续用pip3命令，需要确保它指向Python3.9的pip：

1. 先给Python3.9安装pip（如果还没装）：

   RUN python3.9 -m ensurepip --upgrade
   

2. 替换系统的pip3软链：

   RUN rm /usr/bin/pip3
   RUN ln -s /usr/bin/pip3.9 /usr/bin/pip3
   

之后再运行pip3 install -e ./mypackage，就会把包安装到Python3.9的环境里了。

额外优化：移除不必要的环境变量 #

你之前设置的PACKAGE_PATH其实没必要，因为pip install -e会自动把包的路径添加到Python的sys.path里，不需要手动设置环境变量。可以去掉这两行：

# ENV PACKAGE_PATH=/mypackage/
# ENV PATH="$PACKAGE_PATH/:$PATH" 

内容的提问来源于stack exchange，提问作者André Lourenço