怎么用py-0列出所有已装Python？

在 Windows 环境下开发时，计算机里往往会随着时间推移安装多个版本的 Python。例如在处理旧项目时需要 Python 3.10，而学习新特性或开发新库时又安装了 Python 3.11 和 Python 3.12。当需要在不同版本之间切换，或者需要配置编辑器解释器时，许多读者最关心的第一件事就是：系统中究竟安装了哪几个版本？哪个版本才是目前直接运行的默认项？

在 Windows 操作系统中，最快、最干净的答案是打开任意终端，输入 py -0。这条命令由 Windows 官方自带的 Python 启动器（Python Launcher）提供，能够在半秒钟内扫描系统注册表并输出当前所有已安装的 Python 版本清单，同时清楚标出哪一个是默认调用项。本文将详细讲解该命令的具体输入方法、输出结果解读、路径探测参数以及排查要点。

一、基础操作：如何正确输入并执行 py -0

在实际操作前，需要先澄清一个常见的输入混淆：标题中的“py-0”在实际命令行语法中是 py -0，即程序名 py 与参数 -0 之间包含一个英文半角空格。其中数字 0 是阿拉伯数字零，而不是英文字母 O。该参数全称为 --list，-0 是官方提供的快捷简写。

详细操作步骤

1. 打开系统控制台终端：按下键盘上的 Win + R 快捷键，输入 powershell 或 cmd 并按回车；也可以在 Windows Terminal 中打开新标签页。普通用户权限即可执行，无需特意使用管理员权限运行。
2. 输入查询命令：在闪烁的光标处完整输入 py -0。
3. 回车获取结果：按下回车键，控制台会立刻返回类似下方的结构化清单。

C:\Users\Developer> py -0
Installed Pythons found by py Launcher for Windows
 -V:3.12 *        Python 3.12 (64-bit)
 -V:3.11          Python 3.11 (64-bit)
 -V:3.10-32       Python 3.10 (32-bit)

二、详细解读：py -0 输出结果代表什么含义

执行 py -0 后输出的每一行文本都包含四个核心信息点。理解这些字段有助于我们在后续工作中精准指定对应版本运行脚本：

最值得关注的是星号 * 的位置。当计算机中安装了多个不同年份发布的 Python 时，很多自动化脚本、文件右键菜单以及双击 .py 文件的默认行为，都由带星号的版本主导。通过 py -0，我们能在第一时间确认默认版本是否符合项目预期。

三、进阶查询：用 py -0p 获知各版本的绝对物理安装路径

在日常开发中，仅知道安装了 Python 3.11 或 3.12 往往还不够。例如：

• 在 VS Code 或 PyCharm 中手动配置解释器，需要指定 python.exe 的具体盘符与目录。
• 需要进入某个特定版本的 Scripts 目录排查全局命令行工具。
• 某次安装不小心使用了自定义路径，需要确认到底装在 C:\Program Files 还是 AppData\Local\Programs。

这时，只需要在 -0 后面追加一个小写字母 p（代表 paths，等价于长参数 --list-paths），即执行 py -0p：

C:\Users\Developer> py -0p
Installed Pythons found by py Launcher for Windows
 -V:3.12 *        C:\Users\Developer\AppData\Local\Programs\Python\Python312\python.exe
 -V:3.11          C:\Program Files\Python311\python.exe
 -V:3.10-32       C:\Users\Developer\AppData\Local\Programs\Python\Python310-32\python.exe

四、底层原理：py.exe 是如何检测出这些安装版本的？

很多开发者会好奇：为什么我们没有手动配置过 PATH 环境变量，py -0 也能精准列出每一个版本？这源于 Python Launcher（PEP 397）在 Windows 系统中的特殊探测设计。

当执行 py -0 时，启动器主要通过以下三层机制遍历系统：

• Windows 注册表（Registry）：官方安装包（来自 python.org）在安装时，会在系统注册表 HKEY_CURRENT_USER\Software\Python\PythonCore 或 HKEY_LOCAL_MACHINE\Software\Python\PythonCore 中写入版本号、安装路径和可执行文件信息。py.exe 会优先读取此目录。
• Microsoft Store 应用列表：如果通过 Windows 应用商店安装过 Python，系统会在应用包清单中留下映射别名，启动器能够识别这些沙盒包。
• 配置文件与环境规则：系统会检查当前用户主目录下的 py.ini 文件或环境变量 PY_PYTHON，以此计算出各个版本的排列顺序以及星号 * 所指向的默认版本。

了解这一原理后，也就理解了它的识别边界：

• 通过 Anaconda / Miniconda 创建的虚拟环境，默认不会写进 Windows 原生 PythonCore 注册表，因此不会在 py -0 中出现。
• 直接解压的绿色版（便携免安装包或嵌入式包）因为没有写注册表，py -0 同样无法探测到。
• 项目内部通过 python -m venv .venv 创建的本地虚拟环境，也不属于全局安装版本，不会列在此处。

五、查出版本后的常用操作与默认切换

通过 py -0 看清本地的所有解释器之后，接下来的核心目标往往是按需使用它们：

1. 直接启动指定版本

利用输出中看到的版本标签，可以在 py 后面直接加上主次版本号：

# 启动 Python 3.11 交互式命令行
py -3.11

# 用 Python 3.10 运行特定脚本
py -3.10 main.py

2. 为特定版本独立安装第三方包

多版本共存时，直接运行 pip install 很容易把包安装到非预期的版本中。最稳妥的方式是结合 -m pip：

# 为 3.12 安装 requests
py -3.12 -m pip install requests

# 为 3.11 查看已装第三方包
py -3.11 -m pip list

3. 切换默认星号 (*) 指向的版本

如果希望在直接输入 py script.py 时默认使用 Python 3.11，可以通过以下两种方式调整：

• 设置环境变量：在系统环境变量中添加 PY_PYTHON，值设为 3.11。在当前终端临时切换可输入 set PY_PYTHON=3.11（PowerShell 下为 $env:PY_PYTHON = "3.11"）。设置后再运行 py -0，会看到星号 * 已经转移到了 3.11 这一行。
• 配置 py.ini 文件：在用户主目录（例如 C:\Users\你的用户名\）下新建或修改名为 py.ini 的文本文件，写入：

  [defaults]
  python=3.11

六、常见问题排查与注意事项

1. 提示“'py' 不是内部或外部命令，也不是可运行的程序”

出现该报错说明系统中没有安装 Python 启动器，或者它的路径没有包含在系统的 PATH 环境变量中。通常排查方法如下：

• 进入 C:\Windows 目录，查看是否存在 py.exe。由于 C:\Windows 默认在系统 PATH 中，只要存在该文件就能在任何终端直接调用。
• 如果不存在，可以重新下载任意较新版本的 Python 官方安装包，双击运行并选择 Modify（修改），在组件选择界面确保勾选了 py launcher 选项，点击下一步完成修复即可。

2. macOS 和 Linux 系统能用 py -0 吗？

py.exe 启动器是 Python 官方专门为 Windows 平台打造的实用工具。在默认的 macOS 或 Linux 发行版中，并不附带原生的 py 命令。在 Unix 系列系统中，通常采用以下方式列出或管理多版本：

• 在终端中输入 which -a python3 查看 PATH 中所有的 python3 执行文件。
• 在终端输入 ls /usr/bin/python* 或 ls /usr/local/bin/python* 检索具体版本二进制文件。
• 使用社区开发的版本管理工具，如 pyenv versions。
• 如果习惯了 Windows 启动器的语法，也可以在 Linux/macOS 上安装开源的第三方移植版本（如 Brett Cannon 开发的 Rust 版本 python-launcher）。

总结

在 Windows 操作系统中，py -0 是最简便、最标准的查看本地已安装 Python 版本的方法。配合 py -0p 显示完整路径，以及 py -X.Y 指定版本运行，能够彻底避免多版本共存时的环境混乱，让多项目开发变得清晰而高效。