一、 前言

从 Python 3.13 开始，Python 官方逐步推广了一种现代化的安装机制——Python Install Manager（简称 PIM 或 PyManager），并宣布传统的 .exe 安装包将逐步停止发布。

作为一名在 Windows 环境下经常需要处理多版本 Python 的开发者，我近期体验了这套新机制的安装、非 C 盘自定义迁移以及多版本环境隔离管理。本文将把这次探索过程整理记录下来，帮助大家顺利完成配置，避免遇到不必要的环境冲突问题。

二、 什么是 Python Install Manager？

在过去，我们在 Windows 上管理多版本 Python 通常需要依赖 pyenv-win、Anaconda 或者手动修改系统 PATH 环境变量。
Python Install Manager 是官方推出的一款轻量化管理服务（通过 Windows MSIX 机制分发）。

• 核心设计：用户无需频繁去官网下载或卸载不同的 .exe 安装包。安装该管理器后，系统会内置一个升级版的 py 命令，可以直接通过命令行一键安装、卸载、切换官方的 CPython 版本。
• 路径管理：它采用了 Windows 11 的“应用执行别名”机制，会自动处理路径，减少了因未勾选“Add to PATH”而导致命令行找不到命令的情况。

三、 卸载老版本与环境深度清理

在转用新管理器之前，如果电脑里已经安装了老版本的 Python，建议进行一次清理，以避免指令冲突。

1. 优先卸载 Python Launcher（必须）

如果之前安装过多个老版本，系统内通常会带有一个名为 "Python Launcher" 的独立组件。由于它和新管理器都会占用 py 这个命令行关键字，请前往 Windows “设置 -> 应用 -> 安装的应用”，搜索并优先卸载 "Python Launcher"。

2. 卸载旧解释器并手动清理残留库

通过 Windows 卸载 Python 时，系统通常只会删除核心文件，曾经通过 pip install 安装的第三方库可能会作为残留文件保留在原路径下。

• 清理方法：卸载旧版 Python 解释器后，按下 Win + R 输入 %localappdata%\Programs\Python（若为自定义路径请前往对应目录），将残留的旧版本文件夹（如 Python311）手动删除。

3. 清理环境变量与执行别名

• 系统环境变量：右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。检查用户和系统的 Path 变量，删掉包含老版本 Python 路径的整行数据。
• Windows 应用执行别名：打开 Windows 11 “设置 -> 应用 -> 高级应用设置 -> 应用执行别名”，找到 python.exe 和 python3.exe。如果它们是“开”的状态，建议手动关闭，防止其引导至微软商店下载默认的占位程序。

四、 自定义 PIM 路径（迁移至 D 盘）

新版管理器默认会将下载的所有 Python 版本存放于 C 盘（%LocalAppData%\Python\）。由于该管理器没有图形化的安装向导，默认无法在安装时通过点击 "Browse" 选择文件夹。
不过，官方在规范（PEP 773）中支持了自定义配置：可以通过 %AppData%\Python\pymanager.json 配置文件来自定义路径。

配置步骤：

1. 前往官网下载并安装 Python Install Manager（双击运行后缀为 .msix 的安装包文件进行安装）。
2. 安装完成后，系统会自动弹出初始化配置向导窗口。此时不建议直接输入 y，因为默认会写入 C 盘路径。
3. 在向导的第一步 Add commands directory to your PATH now? [y/N] 和第二步 Install CPython now? [y/N] 中，均输入 n（或 N），正常结束并关闭该向导窗口。
4. 按下 Win + R 键，输入 %AppData% 并回车，进入当前用户的 Roaming 目录。
5. 在该目录下，新建一个名为 Python 的文件夹（若已存在则直接进入）。
6. 在 Python 文件夹内，新建一个文本文件，将其重命名为 pymanager.json（注意需要显示文件扩展名，确保删掉末尾的 .txt 后缀）。
7. 使用文本编辑器打开该 JSON 文件，将以下配置写入（这里以迁移至 D 盘为例，可以根据实际需求修改盘符与路径）：

{
    "install_dir": "D:\\Software\\Python\\Runtimes",
    "global_dir": "D:\\Software\\Python\\Bin",
    "download_dir": "D:\\Software\\Python\\Cache",
    "default_tag": "3.12"
}

• install_dir：未来下载的所有 Python 多版本解释器实体存放的目录。
• global_dir：全局命令和入口程序（如快捷别名）存放的目录。
• default_tag：控制全局默认的 Python 版本。

五、 激活环境与多版本实战

配置好 pymanager.json 后，打开一个新的 CMD 或 PowerShell 终端即可开始使用。

1. 一键下载并安装指定版本

我们可以尝试下载稳定的 3.12 版本：

py install 3.12

管理器会自动连接官方服务器并解压。此时，对应的文件便会保存在您设置的 D:\Software\Python\ 相关目录下。

2. 激活并补全传统的 PATH 环境变量

安装好第一个 Python 后，需要将配置的 D 盘全局 Bin 目录写入系统变量。在终端运行：

py install --configure

向导启动后会识别到自定义路径（例如 D:\Software\Python\Bin），输入 y 并回车。这种方式会将路径写入当前用户的 Path 变量中，保持了操作系统全局环境的整洁。

3. 查看与验证

关闭当前窗口，重新打开一个新的 CMD 窗口：

• 运行 py --list：能够看到所有已安装的版本，且默认版本前会带有一个星号 *。
• 运行 python --version：将打印出相应的 Python 3.12.x 版本。
• 运行 pip --version：输出信息中会显示其指向 D:\Software\Python\... 对应的路径。

六、 日常开发：第三方库与虚拟环境 (venv)

日常开发的使用体验与传统方式基本一致，但多版本管理会更加方便。

1. 第三方库安装

直接运行 pip install <package_name> 会默认安装到当前的默认版本（如 Python 3.12）中。
如果需要针对特定版本进行隔离安装，可以带上版本号前缀：

py -3.12 -m pip install numpy
py -3.14 -m pip install numpy

2. 虚拟环境 (venv) 创建

新管理器与 Python 传统的虚拟环境兼容。进入项目目录后：

• 显式指定版本创建（推荐）：

py -3.12 -m venv my_env

• 使用默认版本创建：

python -m venv my_env

创建完成后，使用传统方式（CMD 下运行 my_env\Scripts\activate 或 PowerShell 下运行 .\my_env\Scripts\activate.ps1）激活虚拟环境，即可在隔离的环境中使用 pip。

七、 结语

官方推出的 Python Install Manager（PIM）虽然改变了传统的图形安装界面，但其采用的 JSON 配置、多版本一键调度以及 Windows 11 执行别名机制在实际使用中较为高效。通过合理配置非 C 盘路径，可以为 Windows 平台提供一个整洁且便于管理的多版本 Python 开发环境。