Windows和Mac终端怎么查看Python版本号

追风的人
追风的人
发布时间:2026-11-13| 3人浏览过
原创

详细讲解在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 中。
Windows和Mac终端怎么查看Python版本号
图 1:Windows 终端查看 Python 版本的操作与分支排查流程

二、Mac 终端查看 Python 版本的标准做法与系统特性

在 Mac 系统中查看 Python 版本,可以通过快捷键 Command + 空格 打开聚焦搜索(Spotlight),输入“终端”或“Terminal”并回车打开命令行窗口。

与 Windows 相比,Mac 在执行命令时有一个关键细节:必须优先输入 python3 --version 而不是 python --version。

Mac 推荐查询命令
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 指令。

Windows和Mac终端怎么查看Python版本号
图 2: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 错误。

Windows和Mac终端怎么查看Python版本号
图 3:核心参数规则与大小写参数行为对比

四、多版本共存时的版本与路径核对方法

在实际开发过程中,计算机上往往不仅安装了一个 Python 环境。例如可能同时存在系统依赖环境、通过 Homebrew 或官方安装包安装的全局版本、Anaconda 数据科学环境,以及针对特定项目的虚拟环境(venv)。当终端输出了某个版本号时,如何确认该版本号到底对应哪一个物理文件?

1. 在 Windows 终端中追溯路径

Windows 提供了 where 命令,可以列出环境变量中当前命令匹配到的全部可执行文件路径:

Windows 路径查询命令
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 版本:

Windows 列出所有注册版本
py -0
示例输出
 -V:3.11 *        Python 3.11 (64-bit)
 -V:3.9           Python 3.9 (64-bit)

其中带有星号 * 的项表示 py 命令默认调用的版本。

2. 在 Mac 终端中追溯路径

Mac 终端可以使用 which 命令来快速获取当前生效的二进制文件绝对路径:

Mac 路径查询命令
which python3
示例输出
/opt/homebrew/bin/python3

如果希望查看系统中所有同名命令在 PATH 中的排列次序,可以使用 -a 参数:

Mac 查找所有匹配路径
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
Windows和Mac终端怎么查看Python版本号
图 4:Windows 与 Mac 终端查看 Python 版本速查全景图
相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。