Python 版本太多难以管理？Pyenv 来救场
内容提要
Pyenv 是管理多个 Python 版本的工具，可安装、切换和卸载版本而不破坏开发环境。文章介绍在 Linux 上通过 curl 安装 Pyenv 并配置 shell，用 pyenv install 安装指定版本，用 pyenv global 设置全局版本、pyenv local 为项目设置局部版本，用 pyenv uninstall 卸载版本，并提醒安装缺失的构建依赖及避免全局版本过旧。
延伸解读
全局版本设置需谨慎
文章通过示例说明，将全局版本设为较旧的 Python 3.8.18 后，运行使用 match-case 语法的代码会报 SyntaxError，因为该语法需要 Python 3.10 及以上。这提醒读者：全局版本应选择较新的版本，避免影响依赖新特性的项目；若系统 Python 较旧，可安装新版并设为全局。
局部版本解决项目兼容问题
对于需要使用旧版 Python 的项目，文章建议在项目目录中运行 pyenv local 设置局部版本，例如 pyenv local 3.8.18。这样在该目录下执行 python 命令时会自动使用指定版本，而不会影响其他项目。这对于维护遗留代码库或同时开发多个版本要求的项目非常实用。
安装失败常见原因与解决
首次使用 pyenv install 安装 Python 版本时，可能会因缺少构建依赖而报错。文章给出的解决方法是运行 apt-get install 安装 build-essential、zlib1g-dev、libffi-dev、libssl-dev 等依赖包。提前安装这些依赖可以避免安装过程中断，确保后续版本管理顺利进行。
Pyenv 与 Docker 的适用场景
文章在结尾提到，Docker 也是解决依赖冲突的优秀方案，但对于简单的本地开发任务可能显得过重。Pyenv 提供了轻量级的命令行版本管理，适合需要快速切换 Python 版本的场景。读者可根据项目复杂度和团队习惯，在 Pyenv 与容器化方案之间做出选择。
Q&A
Pyenv 是什么？它主要解决什么问题？
Pyenv 是一个管理多个 Python 版本的工具，可以安装、切换和卸载 Python 版本，而不会破坏开发环境。它帮助开发者在同一台机器上同时使用不同版本的 Python，例如在尝试新版本特性的同时维护旧代码库。
在 Linux 上如何安装 Pyenv？
在 Linux 上，最简单的安装方式是运行命令：curl https://pyenv.run | bash。安装完成后，需要将以下内容添加到 ~/.bashrc 文件以配置 shell 环境：echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc；echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc；echo 'eval "$(pyenv init -)"' >> ~/.bashrc。
如何使用 Pyenv 安装指定的 Python 版本？
使用 pyenv install 命令安装指定版本，例如 pyenv install 3.8 会安装 Python 3.8 的最新发行版。也可以指定具体版本号，如 pyenv install 3.8.18。运行 pyenv install --list 可以查看所有可安装的版本列表。
pyenv global 和 pyenv local 有什么区别？
pyenv global 用于设置全局 Python 版本，即命令行中默认使用的版本；pyenv local 用于为当前项目目录设置局部 Python 版本，仅在该目录下生效。例如，pyenv global 3.12 设置全局版本为 3.12，而 pyenv local 3.8.18 在项目目录中设置局部版本为 3.8.18。
安装 Python 版本时遇到构建依赖错误怎么办？
首次使用 pyenv install 安装 Python 版本时，可能会因为缺少构建依赖而报错。可以通过包管理器安装所需依赖，例如在 Ubuntu 上运行：apt-get install build-essential zlib1g-dev libffi-dev libssl-dev libbz2-dev libreadline-dev libsqlite3-dev liblzma-dev。安装后即可正常安装 Python 版本。
如何卸载不再需要的 Python 版本？
使用 pyenv uninstall 命令卸载指定版本，例如 pyenv uninstall 3.8.18。系统会提示确认，输入 y 即可卸载。
