编译版CPython3.12的venv虚拟环境包全局安装问题求助

问题概述 #

自行编译CPython 3.12版本后，使用venv创建虚拟环境，激活环境后通过pip安装的包并未存入虚拟环境目录，而是被安装到全局路径/home/USER_NAME/.local/lib/python3.12/site-packages/。多次删除重建虚拟环境后问题依旧，系统同时安装了Python 3.9、3.11、3.12多个版本。

复现步骤 #

1. 查看全局已安装包

$ python -m pip list
Package Version
------- -------
pip     23.3.1

2. 在目标目录创建虚拟环境

$ python -m venv ./myenv

3. 激活虚拟环境

$ source ./myenv/bin/activate

4. 安装测试包

(myenv) $ python -m pip install pypdf

5. 检查虚拟环境内包列表

(myenv) $ python -m pip list
Package Version
------- -------
pip     23.3.1
pypdf   3.17.1

6. 退出虚拟环境

(myvenv) $ deactivate

7. 再次查看全局包列表，发现pypdf已被全局安装

$ python -m pip list
Package Version
------- -------
pip     23.3.1
pypdf   3.17.1   # <- 该包本应仅存在于虚拟环境中

补充信息 #

系统信息 #

import platform
uname = platform.uname()
for attr in ['system', 'release', 'version', 'machine']:
    print(f"{attr:<12} {getattr(uname, attr)}")

system       Linux
release      5.10.0-26-amd64
version      #1 SMP Debian 5.10.197-1 (2023-09-29)
machine      x86_64

终端环境 #

$ echo $SHELL
/bin/bash

Python版本 #

$ python --version
Python 3.12.0

关键排查线索 #

• 全局环境与激活虚拟环境后，执行python -c "import sys; print(sys.executable)"均指向/home/USER_NAME/PATH/Python-3.12.0/python（编译后的Python主程序）
• which python输出存在差异：
  • 全局环境：/usr/bin/python（对应Python 2.7.18）
  • 激活虚拟环境后：/home/USER_NAME/PATH/myenv/bin/python

解决方案建议 #

1. 检查虚拟环境Python可执行文件的链接关系
   查看虚拟环境内的Python是否为符号链接：

   ls -l /home/USER_NAME/PATH/myenv/bin/python
   

   若指向全局编译的Python主程序，尝试使用--copies参数重新创建环境，强制复制Python文件而非符号链接：

   python -m venv --copies ./myenv_new
   

2. 检查pip配置是否存在全局覆盖
   激活虚拟环境后，查看pip的配置项：

   (myenv) python -m pip config list
   

   若存在install.target或类似路径配置，可通过以下命令重置：

   (myenv) python -m pip config unset install.target
   

3. 验证虚拟环境环境变量
   激活环境后，确认VIRTUAL_ENV变量指向正确路径：

   echo $VIRTUAL_ENV
   

   同时检查PYTHONPATH是否包含全局site-packages路径，若有则清空：

   unset PYTHONPATH
   

4. 重新编译Python并指定独立安装目录
   若编译时未指定--prefix，可能导致环境隔离失效。重新编译安装：

   cd Python-3.12.0
   ./configure --prefix=/home/USER_NAME/.local/python3.12
   make && make install
   

   之后使用该独立目录下的Python创建虚拟环境：

   /home/USER_NAME/.local/python3.12/bin/python -m venv ./myenv
   

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