Windows 使用 Python Install Manager 安装多个py环境并切换

Windows 使用 Python Install Manager (PyManager) 笔记

一、下载并安装 PyManager

从清华镜像站下载安装包：

https://mirrors.tuna.tsinghua.edu.cn/python/pymanager/

选择对应架构的文件：

• python-manager-x64.msix
• python-manager-x86.msix
• python-manager-arm64.msix

双击安装。若系统阻止，开启"开发者模式"或"旁加载应用"。

安装完成后重启终端，验证：

py --version
py --help

---

二、配置镜像源

2.1 创建配置文件

路径：

%AppData%\Python\PyManager.json

即：

C:\Users\你的用户名\AppData\Roaming\Python\PyManager.json

若 Python 文件夹不存在，手动创建。

2.2 配置文件内容

{
  "install": {
    "source": "https://mirrors.tuna.tsinghua.edu.cn/python/index-windows.json"
  },
  "default_tag": "3.12"
}

保存后重启终端。

2.3 验证配置

py config --show

看到 install.source 指向清华镜像即为成功。

---

三、查看可安装版本

py list --online

只看特定系列：

py list --online 3.12
py list --online 3.13

查看本机已安装版本：

py list
py -0
py -0p

---

四、安装 Python 版本

安装单个版本：

py install 3.12.5

一次安装多个：

py install 3.11.9 3.12.5 3.13.0

强制重装：

py install -f 3.12.5

指定架构：

py install 3.13.0-arm64
py install 3.13.0-64

自由线程版：

py install 3.13t

---

五、切换与指定 Python 版本

5.1 运行指定版本

进入交互式：

py -3.12
py -3.11

运行脚本：

py -3.12 main.py
py -3.13 tools/run.py

5.2 为指定版本安装包

py -3.12 -m pip install requests
py -3.11 -m pip install -r requirements.txt

5.3 设置默认版本

已在配置文件中设置 "default_tag": "3.12"，之后直接 py 即走 3.12。

也可用环境变量：

setx PYTHON_MANAGER_DEFAULT "3.12"

---

六、创建虚拟环境（推荐）

py -3.12 -m venv .venv
.\.venv\Scripts\activate
python --version
pip install -r requirements.txt

另一个项目用 3.13：

py -3.13 -m venv .venv
.\.venv\Scripts\activate

退出虚拟环境：

deactivate

关于激活的重要说明

.\.venv\Scripts\activate 只对当前这一个终端窗口生效：

• 终端 A 激活后，python 指向 venv 里的版本
• 终端 B 没激活，python 仍是全局版本
• 关闭终端 A，激活效果消失
• 新开终端 C，需要重新激活

每个终端窗口都需要单独激活一次才能在该窗口使用虚拟环境。

---

七、配置 pip 源

py -3.12 -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

或全局配置：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

---

八、卸载 Python 版本

py uninstall 3.11.9

不询问直接卸载：

py uninstall -y 3.11.9

清除全部：

py uninstall --purge

---

九、常用命令速查

命令	说明
py --version	查看版本
py --help	查看帮助
py list	已安装版本
py -0	已安装版本（简略）
py -0p	已安装版本+路径
py list --online	可安装版本
py list --online 3.12	过滤可安装版本
py install 3.12.5	安装指定版本
py install 3.11.9 3.13.0	安装多个版本
py uninstall 3.11.9	卸载版本
py config --show	查看配置
py -3.12	进入 3.12 交互式
py -3.12 main.py	用 3.12 运行脚本
py -3.12 -m pip install x	为 3.12 安装包
py -3.12 -m venv .venv	用 3.12 创建虚拟环境