Windows和Mac终端怎么查看Python版本号
详细讲解在Windows和Mac终端查看Python版本号的标准命令、操作步骤、常见报错排查及大小写参数辨析。
在终端中查看当前安装的 Python 版本号,核心方法是运行带有版本参数的命令行指令。在 Windows 系统中,进入命令提示符(CMD)或 PowerShell 输入 python --version 或 py --version;在 Mac 系统中,打开“终端”(Terminal)输入 python3 --version。命令执行后,终端会直接输出类似 Python 3.11.8 的版本信息。
一、Windows 终端查看 Python 版本的具体步骤与故障排查
在 Windows 环境下查看 Python 版本,首先需要打开系统内置的命令行工具。可以通过键盘快捷键 Win + R 呼出“运行”对话框,输入 cmd 或 powershell 并按回车,也可以右键点击“开始”菜单图标,选择“终端”或“Windows PowerShell”。
python --version
Python 3.10.11
除了完整的 --version 参数外,也可以使用单字母大写参数 python -V,二者效果完全一致。如果在输入后遇到了异常情况,可以按照以下两种常见场景排查:
- 场景一:回车后自动弹出了微软应用商店(Microsoft Store)页面。这是 Windows 10 与 11 自带的“应用执行别名”机制在起作用。当系统 PATH 环境变量中未找到实际的 Python 执行程序时,系统会自动重定向到应用商店提示下载。此时可以在 Windows 设置中搜索“应用执行别名”,关闭对应
python.exe和python3.exe的别名开关,或者直接改用官方启动器命令py --version。 - 场景二:提示“'python' 不是内部或外部命令,也不是可运行的程序”。这说明安装 Python 时未勾选“Add python.exe to PATH”。可以先尝试运行
py --version,因为 Windows 官方安装包通常会默认全局注册py.exe启动器;如果依然提示不存在,则需要手动将 Python 的安装根目录及 Scripts 目录添加到系统的环境变量 PATH 中。
二、Mac 终端查看 Python 版本的标准做法与系统特性
在 Mac 系统中查看 Python 版本,可以通过快捷键 Command + 空格 打开聚焦搜索(Spotlight),输入“终端”或“Terminal”并回车打开命令行窗口。
与 Windows 相比,Mac 在执行命令时有一个关键细节:必须优先输入 python3 --version 而不是 python --version。
python3 --version
Python 3.12.3
很多初次使用 Mac 的用户在输入 python --version 时,会遇到以下提示:
zsh: command not found: python
出现该提示属于正常系统预期。在早期的 macOS 版本中,系统曾内置过 Python 2.7,当时绑定在 python 命令上。但自 macOS Monterey 12.3 起,苹果彻底移除了系统内置的 Python 2.7,且现代 macOS 默认并不会为 python 自动创建指向 python3 的软链接。因此,在没有手动配置别名(alias)的情况下,Mac 终端无法识别无数字后缀的 python 指令。
三、关键参数辨析:容易混淆的命令与行为差异
在日常使用中,很多初学者由于习惯了其它软件(如 Node.js 的 node -v)的参数规则,容易误用参数,导致行为不符合预期。理解以下几个细节能避免常见困惑:
1. 大写 -V 与小写 -v 的根本区别
这是最容易产生混淆的地方。在 Python 解释器中:
- 大写
-V(或--version):代表 Version。它的作用是单次输出版本信息,输出完成后立即退出并交还命令行控制权。 - 小写
-v:代表 Verbose(详细模式)。当输入python -v或python3 -v时,Python 会以“详细调试模式”启动交互式解释器,在终端中连续打印大量模块初始化与导入路径日志,最终停留在一个带有>>>提示符的交互界面中。
若不小心误输入小写 -v 卡在交互环境该怎么办?
直接在 >>> 提示符后输入 exit() 并按回车即可退出;也可以使用快捷键:Windows 环境下按 Ctrl + Z 后回车,Mac 环境下按 Ctrl + D 即可返回常规终端。
2. 横线数量的书写规范
单字母简写参数使用单横线(例如 -V),完整单词参数使用双横线(例如 --version)。如果混写成 -version(单横线加完整单词),终端会将 -e、-r、-s 等当成一系列组合的单字符参数来解析,从而抛出 unknown option 错误。
四、多版本共存时的版本与路径核对方法
在实际开发过程中,计算机上往往不仅安装了一个 Python 环境。例如可能同时存在系统依赖环境、通过 Homebrew 或官方安装包安装的全局版本、Anaconda 数据科学环境,以及针对特定项目的虚拟环境(venv)。当终端输出了某个版本号时,如何确认该版本号到底对应哪一个物理文件?
1. 在 Windows 终端中追溯路径
Windows 提供了 where 命令,可以列出环境变量中当前命令匹配到的全部可执行文件路径:
where python
C:\Users\Username\AppData\Local\Programs\Python\Python311\python.exe
C:\Users\Username\AppData\Local\Microsoft\WindowsApps\python.exe
输出结果的第一行即为终端当前默认执行的 Python 解释器。此外,Windows 用户还可以利用 py -0(数字零)命令列出系统已注册的所有 Python 版本:
py -0
-V:3.11 * Python 3.11 (64-bit)
-V:3.9 Python 3.9 (64-bit)
其中带有星号 * 的项表示 py 命令默认调用的版本。
2. 在 Mac 终端中追溯路径
Mac 终端可以使用 which 命令来快速获取当前生效的二进制文件绝对路径:
which python3
/opt/homebrew/bin/python3
如果希望查看系统中所有同名命令在 PATH 中的排列次序,可以使用 -a 参数:
which -a python3
/opt/homebrew/bin/python3
/usr/local/bin/python3
/usr/bin/python3
终端在执行命令时,总是按照从上到下的顺序寻找第一个可用的文件。因此,排在最上面的路径直接决定了 python3 --version 所返回的版本号。
五、双系统查看 Python 版本速查全景与总结
为了便于快速查阅与比对,下表整理了 Windows 与 Mac 平台在终端中处理 Python 版本的核心命令与要点:
| 功能与操作 | Windows 平台 | Mac 平台 |
|---|---|---|
| 推荐版本查询命令 | python --version 或 py --version |
python3 --version |
| 单字母简写命令 | python -V(必须大写) |
python3 -V(必须大写) |
| 查询解释器文件路径 | where python |
which python3 |
| 列出所有已装版本 | py -0 或 py --list |
which -a python3 |
| 常见报错表现 | 跳转应用商店 / 不是内部或外部命令 | zsh: command not found: python |
| 退出误入的交互环境 | 输入 exit() 或 Ctrl + Z 后回车 |
输入 exit() 或按快捷键 Ctrl + D |
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









