如何解决pip3全局安装的模块无法被python3正常导入的问题
根因说明
CentOS/RHEL 系发行版通过 yum 打包的 python3-pip 做了定制化修改,默认将全局安装的 Python 模块写入 /usr/lib/python3.x/site-packages/pip/_vendor/ 路径,而非 site-packages 根目录,属于发行版打包的特殊配置,并非 pip 官方默认行为。
解决方案
方案1:修复pip默认安装路径(更推荐)
直接升级 yum 安装的 pip 到官方上游版本即可恢复默认安装逻辑,全程使用 Ansible 原生模块参数,无需硬编码任何路径:
- name: 升级 pip3 到官方稳定版,修复发行版打包的路径异常 ansible.builtin.pip: name: pip state: latest executable: pip3 become: yes
升级完成后,后续通过同一个 pip 模块安装其他第三方模块时,默认会直接写入对应 Python 版本的 site-packages 根目录,无需额外配置即可正常导入。
方案2:添加pip/_vendor到Python检索路径
如果不希望修改当前 pip 版本,可以通过动态生成 .pth 配置文件的方式让 Python 自动检索 pip/_vendor 路径,同样无需硬编码 site-packages 路径:
- name: 获取当前 Python3 对应的 site-packages 绝对路径 ansible.builtin.command: python3 -c "import site; print(site.getsitepackages()[0])" register: python_site_packages changed_when: false - name: 添加 pip/_vendor 到 Python 模块检索路径 ansible.builtin.copy: content: "{{ python_site_packages.stdout }}/pip/_vendor" dest: "{{ python_site_packages.stdout }}/pip_vendor.pth" mode: '0644' become: yes
配置完成后所有 Python 进程都会自动读取 .pth 文件中的路径作为模块检索目录,无需重启服务即可生效。
内容的提问来源于stack exchange,提问作者dsollen
相关产品推荐
相关产品推荐

