Windows 和 macOS 下怎么在命令行查 Python 版本
全面讲解在 Windows(CMD/PowerShell)与 macOS(Terminal)命令行中查看 Python 版本的具体命令、参数细节、多版本切换及常见报错排查方案。
python --version(Windows 常用)与 python3 --version(macOS 标配)。本文将详细梳理两个系统的终端打开方式、常用查询参数、Windows 专用的启动器命令、macOS 历史版本的命名差异,以及排查“找不到命令”或误跳应用商店等常见问题。
一、快速查询:常用命令速查总览
不同操作系统的命令行工具不同,环境变量与默认解释器命名也存在差异。在开始具体操作前,可以通过下面的快速分流图了解当前操作系统应该优先尝试的命令。
二、Windows 命令行查 Python 版本
1. 打开 Windows 命令行环境
在 Windows 中,你可以选择“命令提示符(CMD)”或“PowerShell”,两者的查询命令完全通用:
- 快捷键方式:按下键盘上的
Win + R组合键,在弹出的“运行”窗口中输入cmd或powershell,按回车键打开。 - 搜索方式:点击任务栏的开始图标或搜索框,输入
终端、PowerShell或cmd并打开。
2. 执行版本查询命令
在打开的黑底或蓝底控制台窗口中,光标闪烁处输入以下命令并按回车:
# 示例输出: Python 3.11.8
也可以使用大写的单字母参数 -V(注意必须是大写,小写 -v 会启动交互模式并输出模块加载日志):
Python 3.11.8
3. 使用 Windows 专属的 Python 启动器(py 命令)
在通过官方安装包安装 Python 时,Windows 通常会默认安装一个轻量级的调度程序——Python Launcher(即 py.exe)。
即使你的系统环境变量中没有将 Python 目录加入 PATH,或者系统中安装了多个不同版本的 Python,py 依然能够工作。
Python 3.12.2
如果你想查看这台 Windows 电脑上一共安装了哪几个版本的 Python,可以直接运行:
# 示例输出(星号 * 代表默认激活的版本): Installed Pythons found by py Launcher for Windows -3.12-64 * -3.10-64 -2.7-64
若需要查看指定大版本的具体小版本,可以加上版本号标识,例如:
Python 3.10.11
三、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,通常会遇到以下两种情况之一:
- 提示
zsh: command not found: python(找不到该命令)。 - 弹出系统弹窗,提示你安装 Xcode 命令行开发者工具(Command Line Tools)。
正确的做法是:无论通过官网安装包、Homebrew 还是 Conda 安装,都应明确键入 python3。
# 示例输出: Python 3.12.3
同样,缩写命令也使用大写的 -V:
Python 3.12.3
3. 查看 Python 实际调用的绝对路径
macOS 开发者经常同时使用多个包管理器(例如既有官网安装包,又有 Homebrew 安装的工具)。
要搞清楚当前查出的版本究竟位于哪一个安装路径下,可以使用 which 命令:
# Apple Silicon 芯片 Mac(M1/M2/M3)通过 Homebrew 安装的典型路径: /opt/homebrew/bin/python3
# 如果是通过 Python 官方 pkg 安装包安装的典型路径: /Library/Frameworks/Python.framework/Versions/3.12/bin/python3
四、Windows 与 macOS 差异与命令对照
为了方便在跨平台开发时快速切换操作习惯,下面将两者的主要差异、参数特性及路径查询工具进行系统对照:
| 功能需求 | Windows 平台 | macOS 平台 | 注意事项与差异点 |
|---|---|---|---|
| 标准版本查询 | python --version |
python3 --version |
macOS 需显式指定尾随的数字 3 |
| 短参数写法 | python -V |
python3 -V |
必须大写 -V,小写 -v 为详细导入调试模式 |
| 启动器 / 多版本管理器 | py --versionpy -0 |
通过 pyenv 或 brew 管理 |
py 是 Windows 安装包原生附带的专用启动器 |
| 定位执行文件路径 | where python |
which python3 |
用于确认当前生效的是哪个解释器(尤其是虚拟环境) |
| 列出所有候选路径 | where python(默认全部列出) |
type -a python3 |
排查多版本 PATH 抢占冲突时极其有效 |
五、常见问题与排查指南
1. 报错:“'python' 不是内部或外部命令,也不是可运行的程序”
这是 Windows 用户最常碰到的问题。原因是在安装 Python 时,未勾选“Add python.exe to PATH”选项,导致控制台无法根据名称在系统目录中找到该程序。
- 直接在命令行运行
py --version。若能正常输出,说明py启动器已经安装,平时可用py代替python。 - 若仍需使用
python,重新运行安装包,在引导页选择“Modify(修改)”,在高级选项中勾选“Add Python to environment variables”。
2. 输入 python 后莫名弹出“微软应用商店(Microsoft Store)”
在 Windows 10/11 中,系统预设了名为 python.exe 和 python3.exe 的快捷别名。如果系统未检测到你安装的 Python 路径,就会自动打开微软应用商店提示你下载安装。
- 打开 Windows “设置”(快捷键
Win + I)。 - 进入 “应用” -> “高级应用设置” -> “应用执行别名”(部分版本在“应用和功能”下方)。
- 在列表中找到名为 “应用安装程序 (python.exe)” 和 “应用安装程序 (python3.exe)”,将右侧开关全部关闭。
3. macOS 提示:“zsh: command not found: python”
如前文所述,macOS 已不再自带名为 python 的可执行程序。请先测试 python3 --version。如果 python3 正常可用,只是想习惯性地输入 python,可以在当前 shell 配置文件中添加别名:
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,查到的便是该项目独立的虚拟环境版本。
六、总结
在命令行中查询 Python 版本的核心操作可以归纳为两句话:
- Windows 用户:在 CMD 或 PowerShell 中运行
python --version;遇到环境问题或多版本共存时,首选py --version与py -0。 - macOS 用户:在 Terminal 中务必输入
python3 --version(或python3 -V),同时可结合which python3确认实际执行文件的路径来源。
只要掌握好参数大小写(大写 -V 或完整单词 --version)、清楚自己所处的操作系统环境以及是否激活了虚拟环境,就可以在任何场景下快速、准确地确认当前的 Python 版本。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









