如何在电脑上同时管理多个 Python 版本

在电脑上同时管理多个 Python 版本，可通过以下方法实现，适用于不同操作系统并兼顾版本隔离与依赖管理：

• macOS/Linux 用户：推荐使用 pyenv，轻量且功能强大。
• Windows 用户：

  使用 pyenv-win（pyenv 的 Windows 移植版），用法与 pyenv 一致。

  或通过 Microsoft Store 安装 Python，原生支持多版本并行（通过 py -3.7、py -3.11 等命令调用）。

• 通过 Git 克隆安装：git clone
  https://github.com/pyenv/pyenv.git
  ~/.pyenv
• 配置环境变量（需添加到 ~/.bashrc 或 ~/.zshrc）：export PYENV_ROOT="$HOME/.pyenv"export PATH="$PYENV_ROOT/bin:$PATH"eval "$(pyenv init -)"
• 验证安装：pyenv --version

• 通过 PowerShell 安装（推荐使用 pipx 或 GitHub 脚本）：pip install pipxpipx install pyenv-win
• 配置环境变量：

  确保 pyenv-win 的安装路径（如 C:Users<用户名>.pyenvpyenv-winbin）已添加到系统 PATH。

• 直接搜索并安装多个 Python 版本（如 Python 3.7、3.11）。
• 调用时使用命令：py -3.7 # 启动 Python 3.7py -3.11 # 启动 Python 3.11

• 影响所有终端会话：pyenv global 3.8.10

• 进入项目目录后运行：pyenv local 3.7.12
• 此后在该目录下执行 python 命令会自动使用 3.7.12。

• 查看版本号：python --version
• 查看实际路径（确认是否生效）：

  Linux/macOS：which python

  Windows：where python

• 解决路径缓存问题：pyenv rehash # 更新 shell 缓存或重启终端。

即使使用多版本管理工具，仍建议为每个项目创建虚拟环境，以隔离依赖库。

• 使用 venv（内置工具）：pyenv global 3.9.16 # 先设置 pyenv 版本python -m venv myproject_env # 创建虚拟环境
• 使用 pipenv（更高级的依赖管理）：pip install pipenvpipenv --python 3.9.16 # 指定 Python 版本创建环境

• venv：

  Linux/macOS：source myproject_env/bin/activate

  Windows：.myproject_envScriptsactivate

• pipenv：pipenv shell

• 激活虚拟环境后，运行：python --versionpip list # 查看独立依赖

• pyenv-win 操作示例：pyenv install 3.10.6pyenv global 3.10.6pyenv local 3.9.5 # 在项目目录下设置
• Microsoft Store 原生调用：py -3.10 -c "print('Hello from Python 3.10')"

• 避免冲突：通过 pyenv 或 Microsoft Store 实现版本共存，无需替换系统默认版本。
• 灵活切换：全局/局部版本设置满足不同场景需求。
• 依赖隔离：结合虚拟环境确保项目间依赖互不干扰。
• 团队协作：统一版本和依赖管理，减少“在我机器上能跑”的问题。

• 命令未找到：检查环境变量是否配置正确，或重启终端。
• 版本切换无效：运行 pyenv rehash 或确认项目目录下是否存在 .python-version 文件。
• 虚拟环境激活失败：确保路径无空格或特殊字符，或尝试重新创建环境。

通过合理使用版本管理工具和虚拟环境，可显著提升开发效率与协作一致性。