Windows cmd中使用py命令查看Python版本的方法

纸上星河

发布时间：2026-11-03 | 5人浏览过

原创

详细介绍在Windows命令提示符(cmd)中使用py命令查看当前默认Python版本及本地所有已安装Python版本与路径的完整操作方法，包含原理剖析与常见报错排查。

Windows 环境配置与调试

适用系统：Windows 10 / 11 / Server 工具对象：cmd.exe 与 py.exe

图 0：Windows cmd 命令行环境下使用 py 命令检查 Python 版本概览

在 Windows 命令提示符（cmd）中，如果已安装官方 Python 发行版，最直接、准确查看当前默认 Python 版本的方式是执行命令 py -V 或 py --version。若系统中同时存在多个不同版本的 Python，还可通过 py -0p 命令一次性列出所有已检测到的版本及其完整安装路径。

一、核心操作：查看当前默认 Python 版本

许多开发者在 Windows 环境下习惯直接键入 python --version，但在多版本共存或尚未手动配置系统全局环境变量 PATH 的情况下，该命令容易出现重名冲突、指向错误路径，或者直接抛出“找不到命令”提示。

自 Python 3.3 起，官方在 Windows 平台上内置了专门的启动工具——Python Launcher（py.exe）。通过 py 命令，无需手动干预系统的环境变量排序，即可快速调度并查询解释器版本。

标准操作步骤

打开 cmd 终端：按下键盘上的 Win + R 快捷键呼出“运行”对话框，输入 cmd 并按回车；或在“开始”菜单搜索“命令提示符”打开。普通的标准用户权限终端即可满足操作要求。
执行查询命令：在命令行光标处输入查询命令并回车：

cmd.exe - 基础版本查询示例

C:\Users\Developer> py -V Python 3.12.2
参数等效说明：大写字母参数 -V 与完整单词参数 --version 功能完全一致。输入以下命令会得到相同输出：

cmd.exe - 完整参数查询示例

C:\Users\Developer> py --version Python 3.12.2

注意事项：参数字母必须为大写字母 V。如果在 cmd 中输入小写字母 py -v，该参数代表启动交互式解释器并输出详细的模块导入调试日志（Verbose），并不会直接退出并仅显示版本号。

二、多版本查询：列出本机安装的所有 Python 版本与路径

在实际开发中，一台 Windows 主机往往会因项目兼容性要求安装多个不同的 Python 版本（例如 Python 3.10、Python 3.11 及 Python 3.12，甚至 32 位与 64 位版本混部）。py 命令提供了强大的枚举与定位能力。

1. 快速列出已安装版本：py -0

在 cmd 中键入 py -0（注意末尾是数字零 0，并非字母 O）或 py --list，终端将扫描并输出本机所有已在系统注册表中登记的 Python 版本：

cmd.exe - 列出所有已安装版本示例

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

输出标志解读：输出结果中带有星号（*）的那一行，表示当前系统环境下 py 命令默认调用的版本。

2. 列出版本及绝对安装路径：py -0p

如果需要配置 VS Code、PyCharm 等编辑器，或者需要查找某个特定版本的具体安装目录，使用 py -0p（或 py --list-paths）是最高效的方式。末尾追加的 p 即代表路径（Paths）：

cmd.exe - 列出版本与绝对路径示例

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

3. 查询指定版本的具体修订版本号

若已知系统存在 Python 3.10，并希望单独核查该分支的精确修订号（如 3.10.11），可以直接将版本代号作为参数传递给 py：

cmd.exe - 查询指定次要版本示例

C:\Users\Developer> py -3.10 -V Python 3.10.11

三、核心机制：为什么在 Windows 下优先使用 py 命令

很多初学者会有疑问：既然系统里有 python 命令，为什么官方推荐使用 py？这源于 Windows 环境与 Unix-like 环境的不同运行机制：

避免 PATH 顺序覆盖：在传统方式下，当安装了多个 Python 时，系统究竟调用哪一个，完全取决于系统环境变量 Path 中各目录出现的先后顺序。后续安装的软件可能意外更改顺序，导致原本正常的工程脚本调用错误版本。
驻留在系统根目录：官方安装向导默认将 py.exe 写入到全局系统目录（如 C:\Windows\py.exe），该目录永久天然位于系统 Path 首位，无需读者手动逐一添加每个 Python 子目录。
注册表智能发现：py.exe 在启动时会读取 Windows 注册表项（HKEY_CURRENT_USER\Software\Python\PythonCore 与 HKEY_LOCAL_MACHINE\Software\Python\PythonCore），自动识别系统中规范安装的所有版本。

四、常用参数速查与场景对比

为了帮助读者在不同开发阶段快速选用最恰当的查询语法，下表对各类参数的具体表现形式与应用场景进行了梳理：

命令格式	等效长参数	反馈信息	典型使用场景
`py -V`	`py --version`	默认 Python 解释器的具体版本号（如 Python 3.12.2）	快速确认当前主解释器版本是否满足运行需求
`py -0`	`py --list`	列出本地注册的所有主/次版本标签及位数，标出默认版本	检查本地多环境安装情况，确认默认解释器指向
`py -0p`	`py --list-paths`	版本标签及对应 `python.exe` 所在的绝对物理磁盘路径	配置 IDE 解释器、排查虚拟环境及多盘符安装路径
`py -X.Y -V`	无	指定特定次要版本的精确补丁号（如 `py -3.10 -V`）	在编写向下兼容代码时验证目标环境的补丁层级

五、常见问题与故障排查

如果在 cmd 中输入 py 相关命令时遇到问题，通常集中在以下两类现象：

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

该报错说明 Windows 命令提示符在其可执行路径列表中未找到 py.exe。主要排查步骤如下：

排查一：检查 Python 是否为官方完整安装。部分精简包或绿色解压版不附带 Python Launcher。如果未安装，请前往 Python 官方网站（python.org）下载正式安装包（Windows Installer）。
排查二：安装时取消了 Launcher 勾选。在官方安装程序的首界面中，通常包含一项名为 “py launcher” 或 “Use Python Launcher (recommended)” 的复选框。如果此前误取消了该项，可重新运行安装包，在界面中选择 Modify（修改），重新勾选该组件并确认安装。
排查三：确认全局路径。检查 C:\Windows\py.exe 是否真实存在。若存在但 cmd 仍提示找不到，说明系统变量 Path 中意外遗失了 C:\Windows 目录，将其补回并完全重启新的 cmd 窗口即可恢复正常。

2. py -0 列出的版本不全，遗漏了某些环境

通过 Anaconda、Miniconda、嵌入式 ZIP 包或自行解压到某目录下的 Python 解释器，默认不会自动在 Windows 注册表中创建注册信息。因此 py.exe 无法自动捕获这些绿色版或第三方发行环境。此类环境建议直接通过其所属目录的绝对路径或激活特定虚拟环境来进行调用和版本查看。