Ubuntu下pyenv-virtualenvwrapper不生效：无法读取pyenv local/shell配置

核心问题原因 #

1. PYENV_VIRTUALENVWRAPPER_PREFER_PYVENV变量冲突：你设置了export PYENV_VIRTUALENVWRAPPER_PREFER_PYVENV="true"，这个配置会强制pyenv-virtualenvwrapper使用Python自带的pyvenv工具创建虚拟环境，而非virtualenv。pyvenv不会自动继承pyenv当前激活的版本上下文，导致创建的环境沿用系统或全局默认Python版本。
2. virtualenv版本不匹配：如果你的virtualenv是通过系统Python安装的，而非当前pyenv激活的Python版本，那么mkvirtualenv会默认调用系统Python来创建环境，忽略pyenv的局部/全局设置。

解决步骤 #

1. 调整.bashrc配置 #

编辑~/.bashrc，修改以下内容：

• 删除或注释掉export PYENV_VIRTUALENVWRAPPER_PREFER_PYVENV="true"这一行。
• 确保保留eval "$(pyenv init -)"和pyenv virtualenvwrapper的执行顺序（前者先初始化pyenv，后者加载插件）。

修改后的相关配置段应为：

#pyenv
export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

#pyenv-virtualenvwrapper plugin
# 移除或注释PYENV_VIRTUALENVWRAPPER_PREFER_PYVENV配置
pyenv virtualenvwrapper

2. 用目标Python版本重新安装virtualenv&virtualenvwrapper #

激活你需要的Python版本（以3.9.17为例），然后通过该版本的pip安装工具：

pyenv global 3.9.17
pip install virtualenv virtualenvwrapper

这一步确保mkvirtualenv调用的是与目标Python版本绑定的工具，而非系统版本。

3. 验证配置与创建环境 #

1. 使.bashrc配置生效：

source ~/.bashrc

2. 进入目标仓库，创建.python-version文件：

echo "3.9.17" > .python-version

3. 确认当前目录Python版本正确：

python --version

4. 创建虚拟环境并验证版本：

mkvirtualenv project
workon project
python --version

此时应该显示3.9.17。

额外注意事项 #

• 不要开启之前注释的VIRTUALENVWRAPPER_PYTHON配置，该变量会强制指定virtualenv使用的Python路径，覆盖pyenv的版本管理逻辑。
• 如果之前创建过错误版本的虚拟环境，可通过rmvirtualenv project删除后重新创建。

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