Windows 下安装与切换多个 Python 版本的方法

2.2 下载并安装不同版本的 Python 解释器

官方渠道获取 Python 安装包

Python 官网（https://www.python.org）提供各操作系统的预编译版本。建议优先从'Downloads'页面选择与系统匹配的版本，避免依赖冲突。

管理多个 Python 版本

开发中常需测试多版本兼容性。可通过以下方式并行安装：

• Windows：使用官方安装程序勾选'Add to PATH'，为不同版本指定独立安装路径
• macOS/Linux：借助 pyenv 工具管理版本切换

验证安装结果

安装完成后，终端执行命令查看版本信息：

python --version
python3.9 --version

上述命令分别调用默认和指定版本的解释器。若输出对应版本号（如 Python 3.9.18），表明安装成功。不同版本可共存，通过具体命令精确调用目标解释器。

2.3 手动配置系统 PATH 环境变量

理解 PATH 环境变量的作用

PATH 是操作系统用于查找可执行程序的环境变量。当在命令行输入指令时，系统会按 PATH 中定义的目录顺序搜索对应程序。

Windows 系统下的配置方法

右键'此电脑' → '属性' → '高级系统设置' → '环境变量'，在'系统变量'中找到 PATH，点击'编辑'并添加新路径，例如：

C:\Program Files\Python39\
C:\Program Files\Python311\

添加后可在任意目录使用 python 命令。

验证配置结果

• Windows：打开 CMD 执行 echo %PATH%

确认新增路径已存在，并测试对应程序是否可直接调用。

2.4 验证各 Python 版本的可执行性与兼容性

在多环境开发中，确保不同 Python 版本的可执行性与兼容性至关重要。需验证脚本在主流版本（如 3.7 至 3.11）中的运行表现。

版本检测脚本

import sys

def check_compatibility():
    version = sys.version_info
    if version < (3, 7):
        print("不支持的 Python 版本，建议使用 3.7+")
        return False
    print(f"当前版本：{version.major}.{version.minor}.{version.micro}")
    return True

if __name__ == "__main__":
    check_compatibility()

该脚本通过 sys.version_info 获取解释器版本信息，判断是否满足最低要求。主版本号、次版本号用于控制兼容性逻辑。

兼容性测试矩阵

2.5 使用 py 启动器（Python Launcher）进行初步管理

Windows 环境下，py 启动器为多版本 Python 的管理提供了便捷入口。通过命令行调用 py 可精确指定 Python 版本，避免环境变量冲突。

基本使用语法

# 调用默认 Python 版本
py
# 指定 Python 3.9 运行脚本
py -3.9 script.py
# 列出已安装的 Python 版本
py -0p

上述命令中，-3.9 表示优先使用 Python 3.9 解释器；-0p 中的 0 对应'版本列表'，p 显示安装路径。

常用选项对比

第三章：利用虚拟环境隔离项目依赖

3.1 virtualenv 与 venv 的原理对比与选择

核心机制差异

virtualenv 与 venv 均用于创建隔离的 Python 运行环境，但底层实现不同。virtualenv 支持多版本 Python 隔离，兼容性更强；而 venv 是 Python 3.3+ 内置模块，依赖于 ensurepip 机制，轻量但功能受限。

功能特性对比

使用示例

# 使用 virtualenv
virtualenv myenv
myenv\Scripts\activate.bat

# 使用 venv
python -m venv myenv
myenv\Scripts\activate.bat

上述命令分别创建并激活虚拟环境。virtualenv 提供更多配置选项，如指定解释器路径；venv 则更简洁，适合基础场景。

3.2 为不同 Python 版本创建独立虚拟环境

在多项目开发中，不同应用可能依赖特定的 Python 版本。为避免版本冲突，使用虚拟环境隔离是最佳实践。通过 pyenv 管理多个 Python 解释器版本，并结合 venv 创建对应虚拟环境，可实现精确控制。

环境创建流程

首先使用 pyenv 安装并切换 Python 版本：

# 安装 Python 3.9.18
pyenv install 3.9.18
# 设置局部版本
pyenv local 3.9.18

该命令在当前目录下生成 .python-version 文件，自动激活指定版本。

创建独立虚拟环境

随后创建隔离环境：

python -m venv myproject_env
myproject_env\Scripts\activate.bat

激活后，所有 pip install 安装的包仅作用于该环境，确保项目依赖独立无干扰。

3.3 激活与退出虚拟环境的最佳实践

激活虚拟环境的正确方式

在进入项目开发前，必须准确激活对应的虚拟环境。不同操作系统下命令略有差异：

# Linux/macOS
source venv/bin/activate

# Windows
venv\Scripts\activate.bat

上述命令通过加载激活脚本修改当前 shell 环境变量，将 PATH 指向虚拟环境的 Python 解释器和可执行文件路径，确保后续安装的包被隔离存储。

安全退出的推荐做法

开发结束后应使用标准命令退出虚拟环境，恢复系统默认 Python 环境：

deactivate

该命令会还原原始 PATH 变量，避免误操作影响全局环境。建议将其作为开发流程的固定收尾步骤，提升环境管理安全性。

第四章：高效切换与管理 Python 版本

4.1 使用 py launcher 指定特定版本运行脚本

在 Windows 系统中，py 启动器（py launcher）允许用户在同一台机器上管理多个 Python 版本，并精确控制脚本的执行环境。

基本语法与版本选择

通过命令行调用不同 Python 版本的通用格式如下：

py -X.Y script.py

其中 -X.Y 表示具体的版本号，例如 -3.9 或 -2.7。若省略 .Y，则使用该主版本的最新次版本。

常用版本调用示例

• py -3：使用最新的 Python 3 版本
• py -2：启动 Python 2（如已安装）
• py -3.10 -c "print('Hello')"：指定 Python 3.10 执行内联代码

默认行为与配置优先级

当未指定版本时，py 默认使用 Python 3 的最新已安装版本。可通过 py -0 查看所有已注册的版本列表及其架构信息。

4.2 第三方工具推荐：pyenv-win 的安装与使用

工具简介

pyenv-win 是 Windows 平台下管理多个 Python 版本的轻量级工具，允许开发者在同一系统中切换不同 Python 版本，适用于多项目环境。

安装步骤

1. 使用 PowerShell 执行安装命令：

Invoke-WebRequest -UseBasicParsing https://pyenv.run | Invoke-Expression

该命令从官方源下载并自动配置 pyenv-win 环境变量。完成后需重启终端或运行 RefreshEnv 刷新环境。

常用命令

• pyenv install --list：列出所有可安装的 Python 版本；
• pyenv install 3.11.5：安装指定版本；
• pyenv global 3.11.5：设置全局 Python 版本；
• pyenv local 3.9.18：为当前项目设置局部版本。

版本切换示例

pyenv versions
# 输出：* 3.10.6 (set by C:\project\.python-version)
# 3.9.18
# 3.11.5

星号表示当前激活版本，通过 pyenv local <version> 可灵活切换，满足项目依赖差异。