Conda环境因sys.path顺序错误加载异常模块的解决咨询

现象说明 #

使用conda 4.14.0版本，激活目标环境后，通过conda list查看numpy版本为1.22.3：

conda list | grep -i numpy
numpy                     1.22.3           py39hc58783e_2    conda-forge

但运行Python导入numpy时，版本却是1.19.5：

Python 3.9.12 | packaged by conda-forge | (main, Mar 24 2022, 23:25:59)
[GCC 10.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import numpy as np
>>> np.__version__
'1.19.5'

查看sys.path确认，Python优先搜索用户本地账户的site-packages，而非conda环境的site-packages：

>>> print(sys.path)
['', '/opt/tljh/user/lib/python39.zip', 
'/opt/main/user/lib/python3.9', 
'/opt/main/user/lib/python3.9/lib-dynload', 
'/home/user/.local/lib/python3.9/site-packages', 
'/opt/main/user/lib/python3.9/site-packages']

解决方法 #

1. 临时调整sys.path顺序（单次会话生效） #

在Python交互环境或脚本中手动调整路径优先级：

import sys
user_site_path = '/home/user/.local/lib/python3.9/site-packages'
if user_site_path in sys.path:
    idx = sys.path.index(user_site_path)
    # 移除原位置后追加到列表末尾，降低优先级
    sys.path.pop(idx)
    sys.path.append(user_site_path)
# 重新导入验证
import numpy as np
print(np.__version__)  # 输出1.22.3

2. 永久禁用用户本地site-packages（环境级生效） #

通过设置PYTHONNOUSERSITE环境变量，让Python忽略用户本地的site-packages目录：

• 临时生效：激活conda环境后执行：

  export PYTHONNOUSERSITE=1
  

• 永久生效：修改conda环境的激活脚本，每次激活环境自动设置变量：

  # 创建环境激活脚本目录（若不存在）
  mkdir -p /opt/main/user/etc/conda/activate.d
  # 写入环境变量配置
  echo 'export PYTHONNOUSERSITE=1' > /opt/main/user/etc/conda/activate.d/disable_usersite.sh
  

  后续激活该环境时，Python将不再加载/home/user/.local/...下的依赖包。

3. 排查环境变量干扰 #

检查是否存在PYTHONPATH环境变量导致路径错乱：

echo $PYTHONPATH

若输出包含用户本地site-packages路径，可在conda环境的激活脚本中添加清除命令：

echo 'unset PYTHONPATH' >> /opt/main/user/etc/conda/activate.d/disable_usersite.sh

4. 检查conda配置 #

确认conda配置中无异常路径干扰：

conda config --show | grep -i path

若存在非预期路径，可通过以下命令移除：

conda config --remove-key <异常路径对应的配置项>

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