MacOS Sonoma下pyenv配置Python遇问题求助

1. 明确Python 3.12.1的安装归属 #

你当前能调用的python3是Homebrew直接安装的版本，不属于pyenv管理范畴，所以pyenv会提示“version `3.12.1' not installed”。先验证这点：

which python3

如果输出是/usr/local/bin/python3或/opt/homebrew/bin/python3，说明是Homebrew版本，需要让pyenv接管或重新安装对应版本。

2. 用pyenv安装Python 3.12.1 #

首先安装编译Python所需的依赖：

xcode-select --install
brew install openssl readline sqlite3 xz zlib

然后执行pyenv安装命令：

pyenv install 3.12.1

安装完成后，设置全局默认版本：

pyenv global 3.12.1

验证设置：

pyenv versions

此时应该看到3.12.1被标记为当前版本。

3. 确保pyenv初始化配置正确 #

检查~/.zshrc文件是否包含以下内容，若缺失则添加：

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

加载更新后的配置：

source ~/.zshrc

4. 解决python命令找不到的问题 #

有两种可选方案：

• 方案一（推荐，pyenv管理）：
  pyenv会在shims目录生成python可执行文件，只要shims路径在PATH最前面，就能直接调用。执行echo $PATH验证，开头应为/Users/<name>/.pyenv/shims:...。

• 方案二（系统级别名）：
  在~/.zshrc中添加别名：

  alias python='python3'
  

  加载配置后生效：

  source ~/.zshrc
  

验证结果 #

执行以下命令确认：

python --version  # 应输出Python 3.12.1
python3 --version # 应输出Python 3.12.1
pyenv versions    # 应显示3.12.1为当前版本

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