如何让pyenv指定的Python 3.10.4在venv内外生效？

核心原因 #

pyenv的shims路径未被加入PATH环境变量的最前端，导致系统自带的Python优先被调用。

修复步骤 #

1. 检查当前PATH配置 #

执行命令查看PATH内容：

echo $PATH

确认$HOME/.pyenv/shims是否出现在最开头。如果它在系统Python路径（如/usr/bin）之后，就会导致系统版本优先被调用。

2. 修正shell初始化配置 #

根据你使用的shell，修改对应配置文件：

• Bash：编辑~/.bashrc或~/.bash_profile
• Zsh：编辑~/.zshrc
• Fish：编辑~/.config/fish/config.fish

在文件末尾添加以下内容（确保顺序正确）：

# 优先使用pyenv的shims路径
export PATH="$HOME/.pyenv/shims:$PATH"
# 初始化pyenv
eval "$(pyenv init -)"

3. 加载更新后的配置 #

执行对应命令重新加载配置，无需重启终端：

• Bash：source ~/.bashrc 或 source ~/.bash_profile
• Zsh：source ~/.zshrc
• Fish：source ~/.config/fish/config.fish

4. 验证配置与设置版本 #

1. 再次检查PATH，确认~/.pyenv/shims在最前：

   echo $PATH
   

2. 设置全局默认版本：

   pyenv global 3.10.4
   

3. 验证当前Python版本：

   python --version
   pyenv versions
   

此时pyenv versions中3.10.4应带有*标记，python --version显示3.10.4。

5. 修复虚拟环境（venv） #

如果之前的venv是用系统Python创建的，需重新创建：

1. 确保pyenv生效后，执行：

   python -m venv my_venv
   

2. 激活虚拟环境：

   # Bash/Zsh
   source my_venv/bin/activate
   # Fish
   source my_venv/bin/activate.fish
   

3. 验证venv内的Python版本：

   python --version
   

此时应显示3.10.4。

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