虚拟环境激活时/usr/bin/pip3无法正常全局安装包如何解决

问题根因 #

这不是pip的bug，核心原因有两点：

• Debian/Ubuntu系列发行版的Python默认配置中，/usr/lib/python3.x/site-packages并不在全局Python解释器的默认模块搜索路径里，只有系统包管理器写入的/usr/lib/python3.x/dist-packages路径会被识别，你调用/usr/bin/pip3安装时默认把包写入了未被纳入搜索路径的site-packages目录，因此非虚拟环境下也无法找到已安装的包。
• 虚拟环境默认开启隔离模式，会屏蔽所有系统级Python包路径，就算全局Python能识别的包，虚拟环境中默认也无法调用。

适配场景的解决方案 #

方案1：指定全局pip安装的目标路径为dist-packages #

执行全局安装时添加参数，强制把包写入系统默认搜索的dist-packages目录：

/usr/bin/pip3 install --install-option="--install-purelib=/usr/lib/python3.8/dist-packages" docker

如果需要虚拟环境也能访问这个全局包，无需重建虚拟环境，直接修改虚拟环境目录下的pyvenv.cfg文件，将include-system-site-packages = false改为true即可。

方案2：执行全局安装前临时清除虚拟环境变量 #

调用/usr/bin/pip3前临时清空虚拟环境注入的相关环境变量，避免pip安装逻辑受虚拟环境影响：

env -i PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" /usr/bin/pip3 install docker

方案3：Ansible任务层直接指定pip参数 #

无需修改Ansible运行的虚拟环境逻辑，直接在对应pip安装任务中添加两个参数即可：

- name: 全局安装docker包
  ansible.builtin.pip:
    name: docker
    executable: /usr/bin/pip3
    extra_args: "--target /usr/lib/python3.8/dist-packages"

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