pyenv安装教程以及命令大全

命令大全

命令	描述
`pyenv install <version>`	安装指定版本的 Python
`pyenv install --list`	列出可安装的所有 Python 版本
`pyenv versions`	列出当前安装的所有 Python 版本
`pyenv global <version>`	设置全局使用的 Python 版本
`pyenv local <version>`	设置当前目录使用的 Python 版本
`pyenv version`	查看当前使用的 Python 版本
`pyenv which python`	查看当前 Python 版本的路径
`pyenv env`	查看当前 `pyenv` 的环境变量配置
`pyenv uninstall <version>`	卸载指定的 Python 版本
`pyenv update`	升级 `pyenv` 到最新版本
`pyenv exec <command>`	在指定 Python 版本环境中执行命令
`pyenv doctor`	检查 Python 构建环境的详细信息（用于调试安装问题）
`pyenv info`	查看 Python 安装的详细信息
`pyenv --version`	查看 `pyenv` 本身的版本
`pyenv global <version>`	设置全局 Python 版本（适用于所有终端）
`pyenv local <version>`	设置当前目录下的 Python 版本（仅对该目录有效）
`pyenv environment`	查看 `pyenv` 的环境变量

macOS安装教程

安装 pyenv 是在 macOS 上管理多个 Python 版本的一个方便方法。以下是一个详细的步骤指南，帮助你在 macOS 上安装并配置 pyenv：

1. 安装 Homebrew（如果你还没有安装的话）

Homebrew 是 macOS 上非常流行的包管理工具，可以让你方便地安装各种软件。首先，检查你的系统是否安装了 Homebrew。

打开终端并运行以下命令：

which brew

如果没有安装 Homebrew，你可以通过以下命令进行安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装过程中，Homebrew 会要求你输入密码并执行一些设置。完成后，确保 brew 命令可以正常工作，执行：

brew --version

如果输出 Homebrew 版本信息，说明安装成功。

2. 安装 pyenv

使用 Homebrew 安装 pyenv。在终端中运行以下命令：

brew install pyenv

这会自动从 Homebrew 仓库中下载并安装 pyenv。

3. 配置 Shell 环境

pyenv 安装完成后，您需要配置终端，使其能够正确使用 pyenv。

编辑你的 shell 配置文件（比如 .zshrc 或 .bash_profile，取决于你使用的 shell）。

如果你使用的是 zsh（macOS 默认的 shell，从 macOS Catalina 开始），编辑 .zshrc 文件：
```
nano ~/.zshrc
```
如果你使用的是 bash（老版 macOS 默认 shell），编辑 .bash_profile 文件：
```
nano ~/.bash_profile
```

在文件中添加以下内容（如果已经有类似的内容，可以直接添加）：

export PATH="$HOME/.pyenv/bin:$PATH"
if which pyenv > /dev/null; then eval "$(pyenv init --path)"; fi
if which pyenv > /dev/null; then eval "$(pyenv init -)"; fi

保存并退出编辑器（对于 nano 编辑器，按 Ctrl + X，然后按 Y 保存并按 Enter）。

4. 重新加载 shell 配置

执行以下命令，使修改生效：

source ~/.zshrc  # 如果你编辑的是 .zshrc
# 或者
source ~/.bash_profile  # 如果你编辑的是 .bash_profile

5. 检查 pyenv 安装

运行以下命令来检查 pyenv 是否正确安装并可用：

pyenv --version

如果一切正常，它会显示 pyenv 的版本号。

6. 安装 Python 版本

现在，你可以使用 pyenv 安装不同版本的 Python。例如，安装 Python 3.10.2：

pyenv install 3.10.2

你可以根据需要安装其他版本，或者查看可用的 Python 版本：

pyenv install --list

7. 设置全局 Python 版本

安装完 Python 版本后，你可以设置一个全局默认版本。例如，要将 Python 3.10.2 设置为全局默认版本：

pyenv global 3.10.2

此后，所有使用 python 命令的地方都会默认使用该版本。

8. 验证 Python 版本

确认 pyenv 是否成功管理了 Python 版本，运行以下命令：

python --version

它应该显示你设置的版本（如 3.10.2）。

9. （可选）安装 Python 环境管理工具 pyenv-virtualenv

pyenv-virtualenv 是一个插件，允许你使用 pyenv 创建和管理 Python 虚拟环境。可以通过以下命令安装：

brew install pyenv-virtualenv

然后在 .zshrc 或 .bash_profile 中加入：

eval "$(pyenv init --path)"
eval "$(pyenv virtualenv-init -)"

重新加载配置文件后，你可以使用 pyenv 创建虚拟环境：

pyenv virtualenv 3.10.2 myenv

10. 解决常见问题

如果你在安装过程中遇到问题，以下是一些常见的解决方案：

缺少依赖： 如果你遇到关于缺少依赖的错误，可以通过安装 gcc 和其他开发工具来解决：
```
brew install gcc
```
未找到 Python 版本： 如果某个 Python 版本安装失败，尝试更新 pyenv 和相关的依赖：
```
brew update
brew upgrade pyenv
```

# macOS设置环境变量，不然切换版本不会生效
vi ~/.zshrc
# 加入下面两行
eval "$(pyenv init --path)"
eval "$(pyenv init -)"

文章目录