1 Pyenv 使用手册

1.1 介绍

Pyenv 是一个 Python 版本管理工具，它允许用户在同一台机器上管理多个 Python 版本。通过 Pyenv，开发者可以轻松切换 Python 版本，安装不同版本的 Python，并为特定项目设置全局或局部 Python 版本。此外，Pyenv 还提供了插件机制，可以扩展其功能，如自动补全等。

1.2 安装 Pyenv

  1. 通过包管理器安装：

    • 在 Ubuntu/Debian 上使用 apt：
      1
      2
      3
      sudo apt update
      sudo apt install autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libncursesw5-dev libbz2-dev libsqlite3-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
      curl https://pyenv.run | bash
    • 在 Fedora 上使用 dnf：
      1
      2
      sudo dnf install gcc-c++ make bzip2 openssl-devel readline-devel sqlite-devel libffi-devel
      curl https://pyenv.run | bash
    • 在 macOS 上使用 Homebrew：
      1
      brew install pyenv

  2. 初始化环境：

    • 在 shell 启动脚本中添加初始化命令，如 ~/.bashrc 或 ~/.zshrc：
      1
      if command -v pyenv > /dev/null; then eval "$(pyenv init --path)"; fi

1.3 使用 Pyenv

  1. 查看已安装的 Python 版本：

    1
    pyenv versions

  2. 安装新的 Python 版本：

    1
    pyenv install 3.8.5

  3. 更新 Python 版本列表：

    1
    pyenv update

  4. 列出可安装的 Python 版本：

    1
    pyenv install --list

  5. 设置全局 Python 版本：

    1
    pyenv global 3.8.5

  6. 设置局部 Python 版本：

    • 在项目目录中：
      1
      2
      cd /path/to/project
      pyenv local 3.8.5

  7. 删除 Python 版本：

    1
    pyenv uninstall 3.8.5

  8. 查看当前激活的 Python 版本：

    1
    pyenv version

  9. 重置当前工作目录的 Python 版本：

    1
    pyenv rehash

1.4 Pyenv 插件

Pyenv 支持多种插件，可以增强其功能，如自动补全、快速切换版本等。

  1. 安装插件：

    • 例如安装 autojump 插件：
      1
      git clone https://github.com/pyenv/pyenv-autojump.git $(pyenv root)/plugins/autojump

  2. 启用插件：

    • 在 shell 启动脚本中添加插件初始化命令：
      1
      if [ -d "$HOME/.pyenv/plugins/autojump" ]; then source "$HOME/.pyenv/plugins/autojump/autojump.sh"; fi

1.5 常见问题

  • 无法识别命令：
    确认是否正确初始化 Pyenv，并且 shell 启动脚本是否包含正确的初始化命令。

  • 安装失败：
    检查是否缺少必要的依赖库，并确保安装环境满足要求。

1.6 结语

Pyenv 是一个强大的工具，可以帮助开发者轻松管理不同版本的 Python。通过本文档，你应能熟练掌握 Pyenv 的基本操作，并能在日常开发工作中有效地利用它。随着对 Pyenv 的深入理解和探索，你还可以发现更多实用的功能和技巧。