Python Install Manager（pymanager） 是 python.org 官方的新一代 Python 版本管理器，py 命令就是它的入口，用来安装、管理、切换多个 Python 版本——可以理解为传统 py launcher 的升级版。从 Python 3.16 起，老的独立安装包会逐步停更，pymanager 是 Windows 上的未来主流。

一、安装

推荐 Microsoft Store（自动更新）：

winget install 9NQ7512CXL7T

或在 Store 搜 “Python Install Manager”。离线场景下 python.org 下载 python-manager-*.msix；企业部署可用 MSI（功能受限，非必要不推荐）。装完重启终端，验证 py --help，并首次运行 py install --configure 开启 App Execution Aliases。

二、版本管理

# 查看
py list                      # 所有已安装
py list --only-managed       # 仅 Manager 装的
py list --online             # 可在线安装的全部
py list --online 3.14# 搜某系列

# 安装
py install 3.14# 指定版本
py install default           # 最新稳定版
py install 3.14t             # 自由线程版
py install 3.14-arm64        # 指定架构
py install -f 3.14# 强制重装
py install -u                # 更新所有已装版本

# 卸载
py uninstall 3.13# 指定版本
py uninstall -y 3.13# 无确认
py uninstall --purge        # 彻底清理所有管理内容

三、使用与切换

py -3.14 script.py            # 用指定版本跑
py -3.14t script.py          # 用自由线程版
py -3.13 -m pip install requests

设默认版本：临时用 $env:PYTHON_MANAGER_DEFAULT = "3.14"；永久改配置文件 %AppData%\Python\pymanager.json 写 { "default_tag": "3.14" }。查看当前默认：py list --one。

四、备用命令 & 离线安装

若 py 与其他工具冲突，用 pymanager install 3.14 / pymanager list 等完整命令。离线场景：

# 有网机器下载
py install --download=C:\PythonOffline 3.143.13
# 离线机器安装
py install --source=C:\PythonOffline\index.json 3.14

五、常见问题

py 命令不可用：系统设置 → 应用 → 应用执行别名，启用 Python 别名；并确保 %LocalAppData%\Microsoft\WindowsApps 在 PATH。

没有全局 python/pip：pymanager 默认不写全局 PATH（推荐行为），用 py -3.14 或项目里用虚拟环境。

与旧 py launcher 冲突：卸载旧的 “Python Launcher”。

日志：%TEMP%\pymanager*.log。

六、小结

① Store/winget 装 pymanager；② py install 3.14 装版本、py list 查；③ py -3.14 切版本；④ 冲突就用 pymanager 全名。

更多相关技术内容咨询欢迎前往并持续关注好学星城论坛了解详情。

想高效系统的学习Python编程语言，推荐大家关注一个微信公众号：Python编程学习圈。每天分享行业资讯、技术干货供大家阅读，关注即可免费领取整套Python入门到进阶的学习资料以及教程，感兴趣的小伙伴赶紧行动起来吧。