Python Manager 常用命令整理

Python Install Manager（命令名 pymanager，日常敲的是 py）是 Python 官方为 Windows 推出的新一代安装管理器，目标是替代传统的 .exe 安装包，让多版本共存和切换变得简单。本文整理日常开发中最常用的几条命令。

一、它和传统安装包有什么不同

传统的 Python for Windows 安装包有几个一直被吐槽的点：装新版本要先卸载旧版本、环境变量要手动配、多版本切换靠 PATH 顺序碰运气。Python Install Manager 把这些统一收进了一个命令行工具：

• 通过 Microsoft Store 分发（MSIX 包），本身不需要管理员权限安装
• 运行时装在用户目录下，多个版本可以并存，互不覆盖
• py、python、python3 等命令通过 Windows 的应用执行别名（App Execution Aliases）暴露出来，不再依赖 PATH 手工配置
• 安装、更新、卸载都由 py 一条命令完成

二、子命令总览

裸敲 pymanager（不带参数）会打印帮助；py help <命令> 可以看某个子命令的完整参数。核心子命令一共五个：

另有一组全局选项，写在子命令之后：-v / -vv 提高日志详细度，-q / -qq 抑制输出，-y 跳过所有确认提示，--config=<路径> 用外部 JSON 文件覆盖配置。

三、日常最常用的 5 条命令

1. 安装指定版本（或最新稳定版）

想装哪个版本直接敲命令，不用再去官网下载、手动配置环境变量：

py install 3.14      # 安装 3.14 系列的最新版本
py install 3.14.0    # 精确到补丁号
py install default   # 直接安装最新的稳定版

2. 查看已安装的 Python 版本

py list              # 列出所有已安装的版本

输出大致长这样，重点是 Tag（版本标签）和 Alias（别名）两列：

Tag           Name                     Managed By        Version       Alias
3.14          Python 3.14.0            Python Install... 3.14.0        python3.14
3.13          Python 3.13.7            Python Install... 3.13.7        python3.13
3.12          Python 3.12.11           Python Install... 3.12.11       python3.12

想看官方目前有哪些版本可以装，加 --online（或简写 -s）：

py list --online

3. 运行指定版本的脚本

不需要切换环境变量，直接指定版本号运行脚本或模块，各版本之间互不干扰：

py -3.14 script.py       # 用 3.14 版本运行脚本
py -3.14 -m pip list     # 用 3.14 版本执行模块

版本选择有两点要注意：

• -3.14 是官方 CPython 版本的简写，完整写法是 -V:3.14；
• 版本选项必须写在其他参数之前，写在后面会被当成传给脚本的参数。

py -V:3.14 script.py     # 等价写法

如果不想指定版本、只要求"用某个版本跑起来"，可以用 exec——它在目标版本尚未安装时会自动装上：

py exec -V:3.13 -m pip --version

4. 卸载不再需要的版本

py uninstall 3.13    # 卸载指定的 3.13 版本

默认会弹一个确认提示（Uninstall Python 3.13.7? [Y/n]），确认后才执行。加 --purge 则是一次性清掉所有受管运行时和缓存。想跳过交互确认，用全局的 -y：

py uninstall 3.13 -y

5. 批量更新所有已安装的版本

py install -u        # 更新所有通过 Manager 安装的 Python 版本

-u 是 --update 的简写，也可以只更新指定版本：

py install -u 3.14   # 只更新 3.14

四、首次使用：配置与应用执行别名

如果刚刚装好 Python Install Manager，建议先在终端运行一次配置检查：

py install --configure

它会逐项检查并引导你修复安装状态，其中包括开启系统的"应用执行别名"，确保 py 命令能正常生效。加 -y 可以直接接受全部修改：

py install --configure -y

如果以后遇到 py 或 python 提示"命令找不到"、或者敲下去直接跳转微软商店，按下面顺序排查：

1. 打开设置 → 应用 → 高级应用设置 → 应用执行别名（也可在开始菜单搜索 "Manage app execution aliases"）；
2. 确认 Python (default) 这一组别名处于开启状态；
3. 若本来就是开着的却仍然失效，把它关闭再重新打开一次，强制刷新别名。

必要时再执行一次 py install --refresh，重建快捷方式、注册表项和全局别名。

五、两个进阶场景

离线安装

先在有网的机器上把安装包拉下来，再拷到目标机器上安装：

# 有网机器：下载到指定目录，形成一个离线索引
py install --download C:\temp\python-pkgs 3.13 3.12

# 离线机器：从本地目录安装
py install --source C:\temp\python-pkgs 3.13

便携 / 免安装副本

只想解压出一份独立的 Python 放进某个目录（不动快捷方式和注册表），用 --target：

py install --target D:\my_embedded_python 3.12

六、速查卡

安装        py install 3.14          装指定版本（default = 最新稳定版）
            py install -u            更新所有已装版本
列表        py list                  已安装的版本
            py list --online         官方在线可装版本
运行        py -3.14 script.py       用 3.14 跑脚本（-V:3.14 等价）
            py exec -V:3.13 ...      跑起来，没装就自动装
卸载        py uninstall 3.13       卸载指定版本
            py uninstall --purge     清空全部受管运行时与缓存
配置        py install --configure   首次配置引导（含应用执行别名）
            py install --refresh     重建快捷方式 / 注册表 / 别名
离线        py install --download DIR 3.13
便携        py install --target DIR 3.12

全局选项    -v/-vv  -q/-qq  -y  --config=<路径>（写在子命令之后）

七、小结

这几条命令基本覆盖了日常 99% 的版本管理需求：装用 py install，看用 py list，跑用 py -3.x，删用 py uninstall，升级用 py install -u。刚开始只需要额外记住 py install --configure 这一次性引导，把应用执行别名配好，后面就都是这几条命令的排列组合了。

本文基于 Python 官方文档与实际使用环境整理，不同版本下子命令参数可能略有差异，具体以 py help <命令> 的输出为准。