Windows 和 macOS (M1/M2) 下使用 Brew 安装 pyenv 教程

以下是适用于 Windows 和 macOS (M1/M2) 的 pyenv 安装与使用教程。由于两种系统安装方式略有不同，我们分别说明。

1. 在 Windows 上安装 pyenv

Windows 上的 pyenv 有一个社区维护的版本，叫做 pyenv-win。

1.1 安装 pyenv-win

安装必要依赖
确保安装以下工具：
- Git: 下载 Git 并安装。
- Python: 安装 Windows 原生的任意 Python 版本（推荐用于基础操作）。

安装 pyenv-win

打开 PowerShell 或 cmd（管理员模式），执行以下命令：

bash
git clone https://github.com/pyenv-win/pyenv-win.git %USERPROFILE%\.pyenv
setx PATH "%USERPROFILE%\.pyenv\bin;%USERPROFILE%\.pyenv\shims;%PATH%"

重启终端，运行以下命令以验证安装是否成功：
```
bash
pyenv --version
```

更新 pyenv-win（可选） 如果你需要更新 pyenv-win：
```
bash
pyenv update
```

1.2 使用 pyenv-win

查看可用的 Python 版本
```
bash
pyenv install --list
```
安装特定 Python 版本 例如安装 Python 3.11.6：
```
bash
pyenv install 3.11.6
```
设置全局 Python 版本
```
bash
pyenv global 3.11.6
```
设置本地（项目）Python 版本 在项目目录下运行：
```
bash
pyenv local 3.11.6
```
查看已安装的版本
```
bash
pyenv versions
```

2. 在 macOS (M1/M2) 上安装 pyenv

2.1 安装必要依赖

安装 Homebrew（如果尚未安装）：
Homebrew 是 macOS 上的包管理工具。打开终端并执行：
```
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

安装依赖工具：
运行以下命令安装 pyenv 依赖：

bash
brew install openssl readline sqlite3 xz zlib tcl-tk git

2.2 安装 pyenv

使用 Homebrew 安装 pyenv
```
bash
brew install pyenv
```

添加 pyenv 到 shell 配置文件 根据你的默认终端，修改对应的配置文件：

如果使用 Zsh（默认终端）：

bash
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init --path)"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
source ~/.zshrc

如果使用 Bash：

bash
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bash_profile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bash_profile
echo 'eval "$(pyenv init --path)"' >> ~/.bash_profile
echo 'eval "$(pyenv init -)"' >> ~/.bash_profile
source ~/.bash_profile

验证 pyenv 是否安装成功
```
bash
pyenv --version
```

2.3 使用 pyenv

列出可用的 Python 版本
```
bash
pyenv install --list
```
安装某个 Python 版本 例如安装 Python 3.11.6：
```
bash
pyenv install 3.11.6
```
设置全局默认 Python 版本
```
bash
pyenv global 3.11.6
```
设置项目本地 Python 版本 在项目目录下运行：
```
bash
pyenv local 3.10.9
```
查看当前使用的 Python 版本
```
bash
pyenv version
```
查看已安装的所有 Python 版本
```
bash
pyenv versions
```
卸载某个 Python 版本
```
bash
pyenv uninstall <version>
```

2.4 使用 pyenv + pyenv-virtualenv

安装 pyenv-virtualenv
```
bash
brew install pyenv-virtualenv
```
配置 pyenv-virtualenv 将以下内容添加到你的 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile）：
```
bash
eval "$(pyenv virtualenv-init -)"
```

创建虚拟环境

bash
pyenv virtualenv <python_version> <env_name>

例如：

bash
pyenv virtualenv 3.11.6 myenv

激活虚拟环境

bash
pyenv activate <env_name>

示例：

bash
pyenv activate myenv

退出虚拟环境
```
bash
pyenv deactivate
```
删除虚拟环境
```
bash
pyenv uninstall <env_name>
```

3. 常见问题

3.1 pyenv 无法安装某些 Python 版本

确保安装了 pyenv 依赖项，例如：

bash
brew install openssl readline sqlite3 xz zlib

如果仍然失败，可以尝试：

bash
export LDFLAGS="-L$(brew --prefix openssl)/lib"
export CPPFLAGS="-I$(brew --prefix openssl)/include"

3.2 Python 编译速度慢

可以通过多线程加速安装：

bash
PYENV_MAKE_OPTS="-j$(nproc)" pyenv install <version>

3.3 pyenv 在 macOS 上未生效

确保你的 shell 配置文件中已正确设置 pyenv 环境变量，并执行 source ~/.zshrc 或重启终端。

通过本教程，你可以在 Windows 或 macOS 上轻松安装并使用 pyenv 来管理 Python 版本。如果有其他问题，可以随时反馈！

目录