Win10同时安装多个Python版本的环境配置方法

许南星
许南星
发布时间:2026-11-18| 5人浏览过
原创

详细讲解在Windows 10系统中同时安装与配置多个Python版本的官方推荐方法。通过Windows Python Launcher启动器管理、环境变量协调与独立虚拟环境隔离,解决版本冲突与pip工具失效问题。

在 Windows 10 环境中开发 Python 项目时,常常会遇到旧项目依赖 Python 3.8、新框架需要 Python 3.11 或 3.12 的现实情况。很多读者的初次尝试往往是反复调整系统环境变量,或者手动把安装目录下的 python.exe 重命名为 python38.exe,结果导致 pip 工具损坏或构建工具报错。在 Win10 下管理多个 Python 版本的最佳实践是依靠官方自带的 Windows Python 启动器(py.exe) 进行调度,并结合虚拟环境(venv)进行项目隔离,既无需改动系统原有文件名,也不会产生调用冲突。

一、多版本共存的核心逻辑:启动器路由机制

理解 Windows 下 Python 多版本并存的关键,在于理清终端执行命令时系统的定位逻辑。当你在命令提示符(CMD)或 PowerShell 中直接输入 python 时,Windows 会沿着 PATH 环境变量中的目录逐个查找可执行程序。如果把多个版本的安装目录都加进 PATH,系统只会执行排在最前的那一个,后面的版本将被完全遮蔽。

Python 官方从 3.3 版本起便为 Windows 平台引入了专用的启动器工具 py.exe。该工具默认安装在 C:\Windows\py.exe,属于系统默认 PATH 路径。它的唯一职责是充当多版本运行时的调度中枢:通过读取命令行指定的版本参数(如 py -3.8、py -3.11),或者自动解析 Python 脚本首行的 Shebang 注释(如 #!python3.8),直接拉起注册表中对应的目标版本解释器,从而彻底解耦各个独立安装的解释器实例。

Win10同时安装多个Python版本的环境配置方法
图 1:Windows 10 下 py.exe 启动器调度多版本 Python 的架构关系

二、标准安装与配置步骤

要在 Win10 上顺利安装并配置多个版本,关键在于明确安装路径与合理设置勾选项。这里以先后安装 Python 3.9 与 Python 3.12 为例进行分步演示。

1. 规划清晰的安装路径

官方安装程序默认路径较深(通常位于 AppData\Local\Programs\Python\...),不仅包含隐藏文件夹,且路径过长容易在编译构建时产生字符超长问题。建议在磁盘根目录或者专用的工具目录建立结构清晰的文件路径,例如:

  • Python 3.9 安装至:C:\Python39
  • Python 3.12 安装至:C:\Python312

2. 执行安装程序的关键选项选择

  1. 双击运行 Python 3.9 官方安装包(Windows installer 64-bit)。
  2. 在安装首屏下方,勾选 “Use admin privileges when installing py.exe”(如果出现)以及 “py launcher”。
  3. 点击 “Customize installation” 进入高级功能选择界面,确保 Documentation、pip、tcl/tk 以及 Python test suite 按需勾选(pip 必须保留)。
  4. 点击 Next 进入 “Advanced Options”:
    • 勾选 “Install Python 3.9 for all users”(这将允许安装到 C 盘根目录并自动配置权限)。
    • 勾选 “Associate files with Python”。
    • 注意:如果打算以 py 启动器为核心,建议取消勾选 Add Python to environment variables,或者仅在安装主力版本时勾选一次,避免多个版本的 Scripts 目录在 PATH 中发生冲突。
    • 修改 “Customize install location” 为之前规划的 C:\Python39。
  5. 点击 Install 完成安装。
  6. 采用同样的方法运行 Python 3.12 安装包,安装目录指定为 C:\Python312。安装程序检测到系统中已有 py.exe 时,会自动将其更新为与最新版本兼容的启动器。
Win10同时安装多个Python版本的环境配置方法
图 2:Win10 双版本 Python 安装与配置的四步标准化流程

三、多版本状态核验与日常调用

安装完成后,打开 Win10 的 PowerShell 或 CMD 窗口,进行版本登记核对与实际命令测试。

1. 检查已识别的 Python 版本列表

在终端输入以下命令:

py -0p

终端将列出系统检测到的全部 Python 解释器、位数以及可执行文件具体位置,例如:

Installed Pythons found by py Launcher for Windows
 -3.12-64 *        C:\Python312\python.exe
 -3.9-64           C:\Python39\python.exe

其中带有星号 * 的行表示当直接输入 py(不加版本号参数)时默认唤起的版本。如果想将 3.9 设为默认版本,只需设置用户环境变量 PY_PYTHON=3.9 即可,无需改动任何系统文件。

2. 日常开发执行与代码运行

无需切换环境变量,随时可以指定目标版本运行脚本或进入交互模式:

# 进入 Python 3.9 交互式命令行
py -3.9

# 进入 Python 3.12 交互式命令行
py -3.12

# 使用 Python 3.9 运行测试脚本
py -3.9 main.py

# 使用 Python 3.12 运行测试脚本
py -3.12 main.py

3. 多版本下的 pip 包管理规范

避坑指南:切勿在命令行中直接输入 pip install 包名。因为当系统中存在多个 Python 时,直接执行 pip 无法保证将库安装到哪一个版本的 site-packages 目录下。

正确的做法是使用 py -版本号 -m pip,通过目标版本的解释器模块机制精准调度:

# 为 Python 3.9 升级 pip 并安装 requests 库
py -3.9 -m pip install --upgrade pip
py -3.9 -m pip install requests

# 为 Python 3.12 安装 numpy 与 pandas 库
py -3.12 -m pip install --upgrade pip
py -3.12 -m pip install numpy pandas

四、为什么不要采用“重命名 python.exe”的民间方法

在早期教程中,常见的方法是进入 C:\Python39 将 python.exe 重命名为 python39.exe,或者复制一份改名。这种做法在短期内看似方便,但会带来一系列隐蔽且难以排查的缺陷:

对比维度 官方 py 启动器方案 手动重命名 python.exe 方案
pip 兼容性 完美支持,py -X.Y -m pip 稳定可靠 极易破坏 pip 的 Windows 包装器,产生 Fatal error 报错
版本小升级 直接覆盖安装,配置无缝继承 升级覆盖会重新生成原名文件,自定义改名失效
Shebang 解析 原生支持 #!python3.9 自动路由 无法识别 Shebang,双击 .py 脚本无法定向分发
虚拟环境构建 venv 模块原生复制或链接正确可执行文件 生成的虚拟环境中可能缺少标准 python.exe 导致激活失效
维护成本 无需手动改名,通过统一指令 py -X.Y 调度 版本越多维护越繁琐,易遗留孤立无效别名
Win10同时安装多个Python版本的环境配置方法
图 3:官方 py 启动器方案与传统改名方案在生态兼容性上的全方位比对

五、多版本最佳实践:结合 venv 虚拟环境开发

在多版本共存的场景下,全局环境主要扮演“版本底座”的角色。为了避免各个项目安装的依赖库相互污染,任何实际的业务开发都应当建立在独立的虚拟环境之上。

1. 使用指定版本初始化虚拟环境

进入项目工程目录后,借助 py -版本号 -m venv 目录名 直接创建基于特定 Python 版本的独立环境:

# 进入业务项目文件夹
cd C:\workspace\demo_project

# 场景 A:需要 Python 3.9 环境
py -3.9 -m venv .venv

# 场景 B:需要 Python 3.12 环境
py -3.12 -m venv .venv

2. 激活虚拟环境并安装依赖

创建完成后,在 Win10 终端中运行激活脚本:

# PowerShell 激活命令
.\.venv\Scripts\Activate.ps1

# CMD 激活命令
.\.venv\Scripts\activate.bat
PowerShell 权限提示:如果执行 Activate.ps1 报错提示“由于在此系统上禁止运行脚本”,可以在管理员模式的 PowerShell 中执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned,允许本地自建脚本执行。

激活环境后,命令行提示符前方会出现 (.venv) 标识。此时终端上下文已被重定向,输入 python 和 pip 均直接作用于当前虚拟环境内部,完全与系统的全局环境隔离开来。

Win10同时安装多个Python版本的环境配置方法
图 4:Win10 系统下多版本 Python 支撑项目虚拟环境与 IDE 集成的日常工作流

六、常见问题排查

1. 输入 python 命令自动跳转到微软应用商店(Microsoft Store)

这是 Windows 10 引入的别名机制干扰。解决方法非常简单:

  1. 按 Win + i 打开 Win10 系统设置。
  2. 依次进入 应用 > 应用执行别名(可在设置搜索框直接搜索“管理应用执行别名”)。
  3. 向下滚动找到并关闭 “应用安装程序 (python.exe)” 和 “应用安装程序 (python3.exe)” 的开关。

2. 输入 py 命令提示“不是内部或外部命令”

这说明在安装 Python 时漏选了 Python Launcher 组件,或者启动器所在目录未正确加入系统 PATH。只需重新运行官方安装包,点击 Modify 并勾选 “py launcher”,或者手动确认系统 PATH 中包含 C:\Windows 或用户环境下的相关启动器路径即可。

3. 需要指定某个项目固定使用特定版本

如果你编写了一个独立的 Python 脚本(非虚拟环境),希望无论谁双击它都能固定由 Python 3.8 打开,只需在该脚本的最开头加入 Shebang 声明:

#!python3.8
# -*- coding: utf-8 -*-
import sys

print("当前解释器版本:", sys.version)

双击该文件或通过 py script.py 启动时,启动器会自动读取第一行并主动拉起 Python 3.8 解释器。

七、总结

在 Windows 10 中同时管理多个 Python 版本并不需要复杂或破坏性的修改。遵循“官方自定义安装到清晰路径 + 依赖系统级 py.exe 启动器分发 + 业务项目落地为独立虚拟环境”的三步策略,能够以零副作用的方式获得清晰、干净、健壮的多版本开发环境。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。