Pyenv 安装与使用指南

Pyenv 安装与使用指南

pyenvSimple Python version management项目地址:https://gitcode.com/gh_mirrors/py/pyenv

Pyenv 是一个用于管理多个 Python 版本的工具，它允许你在不同的项目中轻松切换或安装特定版本的 Python。以下是根据 Pyenv 的官方仓库编写的安装和使用教程。

1. 项目目录结构及介绍

在 Pyenv 的源代码仓库中，主要目录结构如下：

• bin/：包含了用于管理系统 Python 版本的脚本，如 pyenv 和 pyenv-virtualenv。
• libexec/：存放了执行不同 Python 功能的脚本，例如安装 Python 版本。
• plugins/：这里存放了一些扩展插件，比如 pyenv-virtualenv 可以方便地创建和管理虚拟环境。
• .gitignore：定义了在 Git 中忽略哪些文件和目录。
• LICENSE：项目许可证文件（通常是 MIT 或其他开放源代码许可）。
• README.md：提供了关于项目的基本信息和安装指南。

2. 项目的启动文件介绍

Pyenv 的核心命令是通过 pyenv 脚本来实现的。当你在终端中输入 pyenv 命令时，系统会寻找这个脚本并执行对应的操作。这通常涉及到以下几个步骤：

• 确保 $PYENV_ROOT 环境变量已设置，指向 Pyenv 的安装目录。
• 将 $PYENV_ROOT/bin 添加到 $PATH 中，以便能够执行 pyenv。
• 将 pyenv init 的输出添加到你的 shell 配置文件（如 .bashrc, .zshrc），来初始化 Pyenv 的环境。

你可以手动运行 pyenv init 来查看它将要添加到 shell 配置中的命令。

3. 项目的配置文件介绍

Pyenv 并没有一个全局的配置文件，但它的行为可以通过以下几种方式调整：

• Shell 配置：在你的 shell 配置文件（如 .bashrc, .zshrc) 中添加 eval "$(pyenv init -)" 以使 Pyenv 正常工作。
• .python-version 文件：在项目根目录下创建此文件，可以指定该项目使用的 Python 版本。例如，写入 3.9.6 表示使用 Python 3.9.6。
• 环境变量：可以设置 PYENV_VERSION 环境变量临时改变 Python 版本。例如，export PYENV_VERSION=3.8.10。

请注意，为了让这些更改生效，你可能需要重新加载你的 shell 会话（source ~/.bashrc 或者新开一个终端窗口）。

额外说明

• 在某些情况下，你可能还需要配置系统路径，确保 pyenv 的 shim 目录位于所有 Python 执行文件之前，这样 Pyenv 就能控制默认的 Python 解释器。

完成上述步骤后，你应该能够顺利地安装、切换和管理多个 Python 版本了。对于更详细的使用方法，建议参考 Pyenv 的官方文档或 GitHub 仓库中的 README。

pyenvSimple Python version management项目地址:https://gitcode.com/gh_mirrors/py/pyenv