PyManager 安装指南(Windows 特供版)

一个让你告别"装个 Python 装到天荒地老"的救星，也是一个让 C 盘减肥的神器。

一、这是什么神仙工具？

先回答一个灵魂拷问：为什么我的 C 盘又满了？

答：因为你把 Python 一版一版地往 C 盘里塞，3.8、3.9、3.10……每个版本的包全都堆在系统盘，C 盘哭了。

PyManager（Python 安装管理器）就是来解决这个问题的。它是 Python 官方团队出品的"包租婆"工具，专门帮你：

• 安装、管理、卸载多个 Python 版本，再也不用担心版本冲突
• 用一条命令切换任意版本：py -V:3.12、py -V:3.14
• 把 Python 安装到你指定的任意盘符（本指南重点，划重点！）

安装后你就有三个全局命令：python、py 和 pymanager。它们就像三兄弟：

• python
  ：默认启动你当前最新的 Python，日常使用它
• py
  ：多版本管理大师，py -V:3.12 想用哪个用哪个
• pymanager
  ：py 的"官方证件照版"，不跟旧版 py.exe 打架，脚本安装请用它

官方文档原话：Windows 不像 Unix 那样自带宽恕系统，Python 得自己动手丰衣足食。

二、安装 PyManager 本体

有两条路，任选其一，内容一模一样（官方说的）：

路线 A：Microsoft Store 版（小白推荐）

1. 打开 微软商店
2. 点"获取"，再点"安装"
3. 打开终端（Win + R，输入 cmd 回车），输入 python 试试
4. 如果它没理你，请往下翻到"故障排查"章节

路线 B：官网下载版（极客推荐）

1. 去 python.org/downloads 下载 PyManager
2. 双击安装，或者用 PowerShell 命令安装：
   powershell    Add-AppxPackage <路径到下载的.msix文件>    
3. 也可以命令行动手，Windows 都自带 WinGet：
   powershell    winget install 9NQ7512CXL7T -e --accept-package-agreements --disable-interactivity    
4. 装完顺手跑个配置检查（可选但建议）：
      py install --configure -y   

安装后第一件事

首次安装运行时，它会问你"要不要把某个目录加进 PATH？"——这个目录默认是 %LocalAppData%\Python\bin，加了之后你就能在终端里直接用 python3.14.exe 这种带版本号的别名。想省心就同意，想精简就拒绝（用 py 命令也能搞定一切）。

💡 温馨提示：PyManager 会自动更新自己，但不会动你已装的 Python 运行时；卸载 PyManager 也不会卸载任何 Python。它是个很有分寸的管家。

三、重头戏：配置文件详解（C 盘拯救计划）

官方说配置文件的优先级是：

命令行参数 > 注册表（仅管理员） > 配置文件 > 环境变量

配置文件采用"洋葱式"层级，从外到内依次覆盖：

1. 管理员配置的全局配置（可选）
2. 用户配置文件：%AppData%\Python\pymanager.json
      - 注意！路径里有 Roaming（漫游），不是 Local，别找错地方
3. 环境变量 PYTHON_MANAGER_CONFIG 或命令行 --config=<路径> 指定的额外配置文件（二选一，不能同时用）

也就是说，你平时只需要改一个文件：%AppData%\Python\pymanager.json，它是一个 JSON 文件。

老规矩：找不到文件就自己建一个，路径放在 %AppData%\Python\ 下，文件名就叫 pymanager.json。

3.1 常用配置表（背下来，考试要考）

3.2 C 盘救星：把 Python 装到 D 盘（必看！）

不想让 C 盘继续惨叫？用 install_dir 配置键，一句话搞定：

{    ”install_dir”: ”D:\\Python”}

这样以后安装的所有 Python 运行时都会乖乖住进 D:\Python，比如 D:\Python\3.14。

⚠️ 重要警告：改了这个设置之后，之前已经装好的运行时并不会自己搬家！除非你手动把它们挪到新位置，否则旧版本会"失联"。

翻译成人话：先改配置，再装新版本，顺序千万别搞反，否则旧版会找不到回家的路。

同理，全局命令和下载缓存也可以安排到 D 盘：

{    ”install_dir”: ”D:\\Python”,    ”global_dir”: ”D:\\Python\\bin”,    ”download_dir”: ”D:\\Python\\downloads”}

点状的键名要嵌套在 JSON 对象里，比如 list.format 要写成：

{    ”list”: {        ”format”: ”table”    }}

3.3 一个完整示范配置文件

{    ”default_tag”: ”3.14”,    ”install_dir”: ”D:\\Python”,    ”global_dir”: ”D:\\Python\\bin”,    ”download_dir”: ”D:\\Python\\downloads”,    ”automatic_install”: true,    ”list”: {        ”format”: ”table”    }}

保存后，重启终端，py list 一下，你就会看到 Python 版图正在向 D 盘转移。

3.4 不想改文件？用环境变量也行

比如懒癌发作，只想指定默认版本，直接在系统设置里加一个环境变量：

PYTHON_MANAGER_DEFAULT=3.12

或者连配置文件都懒得找，用命令行临时指定：

py --config=D:\myconfig.json ...

⚠️ PYTHON_MANAGER_CONFIG 环境变量和 --config 命令行参数只能二选一，贪心会报错哦。

四、日常使用快速上手

查看已安装的版本

py list

查看哪些版本可以装（联网）

py list --online 3.14

安装指定版本

py install 3.12py install 3.14

一次装多个也行：py install 3.11 3.12 3.13

指定版本启动

py -V:3.12 my-script.py

卸载不想要的版本

py uninstall 3.12

想连根拔起、所有 PyManager 管的版本全清掉？

py uninstall --purge

装个"自由线程"（玩命版）Python

想要传说中的 free-threaded（去掉 GIL）版本？后缀加个 t：

py install 3.14t

创建虚拟环境（官方强烈建议）

每个项目一个虚拟环境，各玩各的互不干扰：

python -m venv myenvmyenv\Scripts\activate

五、离线安装（内网用户的福音）

没网也能装？能，但得先在有网机器上"打包"：

py install --download=D:\offline 3.12 3.14

这个命令会下载运行时并生成 index.json，把整个 D:\offline 文件夹拷到内网机器上：

py install --source=”D:\offline\index.json” 3.12

搞定，从此断网不断命。

六、管理员进阶（企业 IT 请进）

管理员可以在注册表里强制覆盖配置：

HKEY_LOCAL_MACHINE\Software\Policies\Python\PyManager

值名跟配置键一样，类型选 REG_SZ。官方推荐只用来设置 base_config（最高优先级配置文件），让用户还能微调自己的部分。

另外，Windows Server 2019 不支持 MSIX 安装，要用 python.org 下载页的 MSI（无 UI，只装 Program Files 默认位置，会帮你改系统 PATH）。

七、故障排查（救火队）

八、总结（结尾小贴士）

一句话记住 PyManager：

装版本用 py install，切版本用 py -V:，换盘用 install_dir，想跑路用 py uninstall --purge。

C 盘瘦身、版本自由、告别环境变量地狱，从 pymanager.json 里的一个 install_dir 开始。

祝大家装机愉快，永不蓝屏。

参考资料：Python 官方文档「Using Python on Windows」第 4 章 Python Install Manager 部分（Python 3.14 文档）