MacBook Pro上Pyenv管理Python版本的Shim路径问题

以下是针对问题的分步解决方案：

• 检查pyenv的Shell初始化配置
  打开你的Shell配置文件（Mac默认是~/.zshrc，使用bash则为~/.bash_profile），确认包含完整的pyenv初始化代码：

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

  保存后重启Shell，执行echo $PATH验证$PYENV_ROOT/shims是否位于系统Python路径（如/usr/bin）之前，确保shim路径优先级最高。

• 重新生成pyenv Shim文件
  手动触发shim文件生成，修复可能的缺失问题：

  pyenv rehash
  

  该命令会为所有已安装的Python版本重新创建对应的shim可执行文件，是解决此类问题的常用手段。

• 验证Python版本安装完整性
  检查对应版本的安装目录是否存在完整的可执行文件：

  ls ~/.pyenv/versions/3.10.16/bin/
  

  正常情况下应能看到python、python3、python3.10等文件。若缺失，说明安装不完整，需重新安装：

  pyenv uninstall 3.10.16
  pyenv install 3.10.16
  

  重复上述步骤检查并修复3.11.x版本的安装。

• 确认Shim路径指向正确
  执行以下命令验证python3.10的路径：

  which python3.10
  

  正确输出应为/Users/你的用户名/.pyenv/shims/python3.10。若输出为系统路径，说明PATH配置有误，回到第一步调整。
  也可使用pyenv which python3.10检查pyenv内部是否能找到该版本，若能找到但Shell无法调用，依然是PATH优先级问题。

• 适配Hatch的版本识别
  确保Hatch能读取pyenv管理的Python版本：

  hatch config set python.resolve true
  

  或在项目根目录的hatch.toml中直接指定所需版本：

  [tool.hatch.environment.default]
  python = "3.11"
  

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