Windows 和 macOS 下怎么在命令行查 Python 版本

Cora
Cora
发布时间:2026-11-22| 6人浏览过
原创

全面讲解在 Windows(CMD/PowerShell)与 macOS(Terminal)命令行中查看 Python 版本的具体命令、参数细节、多版本切换及常见报错排查方案。

在命令行中查询已安装的 Python 版本,最核心的命令是 python --version(Windows 常用)与 python3 --version(macOS 标配)。本文将详细梳理两个系统的终端打开方式、常用查询参数、Windows 专用的启动器命令、macOS 历史版本的命名差异,以及排查“找不到命令”或误跳应用商店等常见问题。

一、快速查询:常用命令速查总览

不同操作系统的命令行工具不同,环境变量与默认解释器命名也存在差异。在开始具体操作前,可以通过下面的快速分流图了解当前操作系统应该优先尝试的命令。

Windows 和 macOS 下怎么在命令行查 Python 版本
图 1:Windows 与 macOS 常用版本查询命令概览

二、Windows 命令行查 Python 版本

1. 打开 Windows 命令行环境

在 Windows 中,你可以选择“命令提示符(CMD)”或“PowerShell”,两者的查询命令完全通用:

  • 快捷键方式:按下键盘上的 Win + R 组合键,在弹出的“运行”窗口中输入 cmd 或 powershell,按回车键打开。
  • 搜索方式:点击任务栏的开始图标或搜索框,输入 终端、PowerShell 或 cmd 并打开。

2. 执行版本查询命令

在打开的黑底或蓝底控制台窗口中,光标闪烁处输入以下命令并按回车:

C:\Users\Admin>python --version
# 示例输出: Python 3.11.8

也可以使用大写的单字母参数 -V(注意必须是大写,小写 -v 会启动交互模式并输出模块加载日志):

C:\Users\Admin>python -V
Python 3.11.8

3. 使用 Windows 专属的 Python 启动器(py 命令)

在通过官方安装包安装 Python 时,Windows 通常会默认安装一个轻量级的调度程序——Python Launcher(即 py.exe)。 即使你的系统环境变量中没有将 Python 目录加入 PATH,或者系统中安装了多个不同版本的 Python,py 依然能够工作。

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

如果你想查看这台 Windows 电脑上一共安装了哪几个版本的 Python,可以直接运行:

C:\Users\Admin>py -0
# 示例输出(星号 * 代表默认激活的版本): Installed Pythons found by py Launcher for Windows -3.12-64 * -3.10-64 -2.7-64

若需要查看指定大版本的具体小版本,可以加上版本号标识,例如:

C:\Users\Admin>py -3.10 --version
Python 3.10.11
Windows 和 macOS 下怎么在命令行查 Python 版本
图 2:Windows 下 Python 版本检测与排查分支流程

三、macOS 终端查 Python 版本

1. 打开 macOS 终端

在 macOS 系统中,你可以使用系统内置的终端(Terminal.app),或者第三方的 iTerm2:

  • 聚焦搜索方式(推荐):按下 Command + 空格键 呼出聚焦搜索(Spotlight),在输入框中键入 Terminal 或 终端,敲击回车打开。
  • 访达目录方式:打开“访达(Finder)” -> 进入“应用程序(Applications)” -> 展开“实用工具(Utilities)”文件夹 -> 双击“终端”。

2. 为什么在 macOS 上必须优先使用 python3

在较早期的 macOS 系统(如 macOS Monterey 12.3 之前),系统内置了由苹果维护的 Python 2.7,通过 python 命令调用。 但在 macOS 12.3 之后,苹果已经从系统中彻底移除了内置的 Python 2 运行环境。

因此,如果你在现代 macOS 终端中直接输入 python --version,通常会遇到以下两种情况之一:

  1. 提示 zsh: command not found: python(找不到该命令)。
  2. 弹出系统弹窗,提示你安装 Xcode 命令行开发者工具(Command Line Tools)。

正确的做法是:无论通过官网安装包、Homebrew 还是 Conda 安装,都应明确键入 python3。

user@MacBook-Pro ~ %python3 --version
# 示例输出: Python 3.12.3

同样,缩写命令也使用大写的 -V:

user@MacBook-Pro ~ %python3 -V
Python 3.12.3

3. 查看 Python 实际调用的绝对路径

macOS 开发者经常同时使用多个包管理器(例如既有官网安装包,又有 Homebrew 安装的工具)。 要搞清楚当前查出的版本究竟位于哪一个安装路径下,可以使用 which 命令:

user@MacBook-Pro ~ %which python3
# Apple Silicon 芯片 Mac(M1/M2/M3)通过 Homebrew 安装的典型路径: /opt/homebrew/bin/python3
# 如果是通过 Python 官方 pkg 安装包安装的典型路径: /Library/Frameworks/Python.framework/Versions/3.12/bin/python3
Windows 和 macOS 下怎么在命令行查 Python 版本
图 3:macOS 下 Python 命令解析与执行路径层次结构

四、Windows 与 macOS 差异与命令对照

为了方便在跨平台开发时快速切换操作习惯,下面将两者的主要差异、参数特性及路径查询工具进行系统对照:

功能需求 Windows 平台 macOS 平台 注意事项与差异点
标准版本查询 python --version python3 --version macOS 需显式指定尾随的数字 3
短参数写法 python -V python3 -V 必须大写 -V,小写 -v 为详细导入调试模式
启动器 / 多版本管理器 py --version
py -0
通过 pyenv 或 brew 管理 py 是 Windows 安装包原生附带的专用启动器
定位执行文件路径 where python which python3 用于确认当前生效的是哪个解释器(尤其是虚拟环境)
列出所有候选路径 where python(默认全部列出) type -a python3 排查多版本 PATH 抢占冲突时极其有效
Windows 和 macOS 下怎么在命令行查 Python 版本
图 4:双平台命令特性与工具矩阵对照

五、常见问题与排查指南

1. 报错:“'python' 不是内部或外部命令,也不是可运行的程序”

这是 Windows 用户最常碰到的问题。原因是在安装 Python 时,未勾选“Add python.exe to PATH”选项,导致控制台无法根据名称在系统目录中找到该程序。

快速补救方法:
  1. 直接在命令行运行 py --version。若能正常输出,说明 py 启动器已经安装,平时可用 py 代替 python。
  2. 若仍需使用 python,重新运行安装包,在引导页选择“Modify(修改)”,在高级选项中勾选“Add Python to environment variables”。

2. 输入 python 后莫名弹出“微软应用商店(Microsoft Store)”

在 Windows 10/11 中,系统预设了名为 python.exe 和 python3.exe 的快捷别名。如果系统未检测到你安装的 Python 路径,就会自动打开微软应用商店提示你下载安装。

关闭应用商店拦截的步骤:
  1. 打开 Windows “设置”(快捷键 Win + I)。
  2. 进入 “应用” -> “高级应用设置” -> “应用执行别名”(部分版本在“应用和功能”下方)。
  3. 在列表中找到名为 “应用安装程序 (python.exe)” 和 “应用安装程序 (python3.exe)”,将右侧开关全部关闭。

3. macOS 提示:“zsh: command not found: python”

如前文所述,macOS 已不再自带名为 python 的可执行程序。请先测试 python3 --version。如果 python3 正常可用,只是想习惯性地输入 python,可以在当前 shell 配置文件中添加别名:

user@MacBook-Pro ~ %echo "alias python='python3'" >> ~/.zshrc
user@MacBook-Pro ~ %source ~/.zshrc

完成上述操作后,输入 python --version 即可正常打印 Python 3 版本。

4. 查出的版本与实际项目运行的版本不一致

如果你在 IDE(如 VS Code 或 PyCharm)中看到项目用的是 Python 3.10,但在终端中查出来是 Python 3.12,通常是因为当前终端尚未激活该项目的虚拟环境(Virtual Environment)。

激活虚拟环境(例如在项目根目录运行 source venv/bin/activate 或 Windows 下 .\venv\Scripts\activate)后,终端提示符前会出现 (venv) 标记,此时再次输入 python --version,查到的便是该项目独立的虚拟环境版本。

Windows 和 macOS 下怎么在命令行查 Python 版本
图 5:常见异常现象与修复方案流程图

六、总结

在命令行中查询 Python 版本的核心操作可以归纳为两句话:

  • Windows 用户:在 CMD 或 PowerShell 中运行 python --version;遇到环境问题或多版本共存时,首选 py --version 与 py -0。
  • macOS 用户:在 Terminal 中务必输入 python3 --version(或 python3 -V),同时可结合 which python3 确认实际执行文件的路径来源。

只要掌握好参数大小写(大写 -V 或完整单词 --version)、清楚自己所处的操作系统环境以及是否激活了虚拟环境,就可以在任何场景下快速、准确地确认当前的 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 算法库。