Windows和Mac下怎么查Python版本?常见命令汇总
全面汇总Windows和Mac系统下查看Python版本的常用命令与专有工具,包括基础命令、多版本定位、执行路径查找及常见报错排查技巧。
python --version 或 python3 --version(大写参数简写为 -V)。然而由于两个操作系统的默认软件配置、环境变量优先级、多版本共存机制以及终端架构存在显著差异,许多读者在键入命令后常会遭遇“未找到命令”、误唤醒应用商店弹窗,或者打印出的版本号与刚刚安装的软件包不一致。本文系统梳理Windows与macOS双平台的版本查询命令、各自专属的管理工具及多环境路径排查技巧。
一、跨平台基础命令与参数规范
无论在Windows还是macOS中,检查版本的第一步都是打开系统内置的终端界面。Windows用户可使用快捷键 Win + R 输入 cmd 打开命令提示符,或右键开始菜单打开 PowerShell / Windows Terminal;macOS用户则可以通过快捷键 Command + 空格 唤出聚焦搜索(Spotlight),输入“终端”或“Terminal”并回车。
在打开的终端窗口中,可依次尝试以下基础查询命令:
# 形式一:完整参数格式
python --version
python3 --version
# 形式二:单字母大写缩写格式
python -V
python3 -V
请特别注意参数的大小写:必须是大写的 -V(大写字母V)。如果误输入为小写的 -v(小写verbose),Python将进入详细交互模式,依次打印解释器初始化时加载的每一个系统模块,最后停留在代码交互提示符(>>>)处,而不是仅输出版本号。
对于大部分常规开发环境,终端在执行上述命令后会立即返回单行文本,例如 Python 3.11.8。如果在执行 python --version 时提示找不到命令,通常表明当前系统中该别名未绑定到可执行文件,应当改用 python3 --version 进行验证。
二、Windows 专有命令:Python Launcher 与路径排查
在 Windows 环境下,通过官方安装包(python.org)安装时,安装程序默认会附带安装一个轻量级的调度程序——Python Launcher(命令为 py)。它通常被安装在 C:\Windows\py.exe 下,而该目录默认处于系统环境变量的最顶层,因此即使在安装 Python 时忘记勾选“Add python.exe to PATH”,py 命令依然可以稳定运行。
1. 使用 py 启动器查看版本
# 查看 py 默认调用的 Python 版本
py --version
py -V
# 列出当前系统中已安装的所有 Python 版本(极为实用)
py -0
py --list
# 列出所有版本及具体安装路径
py -0p
执行 py -0 命令时,输出内容会标注出当前机器中所有被识别的 Python 版本,并在默认使用的版本前加上星号(*)。例如:
Installed Pythons found by py Launcher for Windows
-3.12-64 * C:\Users\User\AppData\Local\Programs\Python\Python312\python.exe
-3.10-64 C:\Users\User\AppData\Local\Programs\Python\Python310\python.exe
2. 查询指定大版本的具体版本号
当机器上共存多个版本时,可以直接指定主版本参数查询:
# 明确查询 Python 3.10 的细分版本号
py -3.10 --version
# 明确查询最新 Python 3 的版本号
py -3 --version
3. 使用 where 命令排查真实路径与执行别名
很多 Windows 用户在输入 python 时,系统并未输出版本号,而是弹出了微软应用商店(Microsoft Store)的页面。这是因为 Windows 预置了名为“应用执行别名”的跳转空指针文件。为了确认终端究竟调用了哪里的 python.exe,可以使用 Windows 自带的 where 命令:
where python
如果输出的第一行指向 AppData\Local\Microsoft\WindowsApps\python.exe,说明系统优先命中了微软商店别名;如果已经安装了官方 Python,可进入“Windows 设置 > 应用 > 高级应用设置 > 应用执行别名”,将对应的两个“应用安装程序 (python.exe)”开关关闭。
三、macOS 专有命令与环境识别
macOS 的 Python 环境随系统版本更迭经历过重大调整。早期 macOS 系统自带 Python 2.7,位于 /usr/bin/python;但自 macOS Monterey 12.3 开始,苹果已彻底从操作系统中移除了内置的 Python 2 运行环境。因此在现代 Mac 上,直接输入 python 通常会收到 zsh: command not found: python 的报错,正确规范是使用 python3。
1. macOS 核心查看命令
# 常用基础命令
python3 --version
python3 -V
2. 使用 which 与 type 定位执行路径
在 Mac 终端中,了解版本号的同时往往需要确认该版本来自哪里(是来自 Xcode 命令行工具、Homebrew、还是官网安装包)。通过 Unix 经典工具 which 和 type 可以轻松完成识别:
# 查看当前执行的 python3 绝对路径
which python3
# 查看 PATH 环境变量中所有匹配的 python3 及其优先级
type -a python3
根据输出路径可快速区分安装来源:
/Library/Frameworks/Python.framework/...:来自 Python 官方网站安装包(PKG);/opt/homebrew/bin/python3:来自 Apple Silicon(M系列芯片)上的 Homebrew 包管理器;/usr/local/bin/python3:来自 Intel 架构 Mac 上的 Homebrew 包管理器;/Library/Developer/CommandLineTools/...或/usr/bin/python3:来自苹果官方 Xcode Command Line Tools。
3. 查询包管理器下的 Python 版本
若读者习惯使用 Homebrew 安装管理环境,可以借助 brew 命令直接枚举本地所安装的所有 Python 配方与版本:
# 查看 Homebrew 安装的 Python 具体版本列表
brew list --versions | grep -i python
四、进阶场景:在代码与虚拟环境中确认精准版本
在编写自动化脚本、部署项目或配置虚拟环境(venv / conda)时,单纯在终端外部检查系统级命令往往不够,我们需要直接在 Python 解释器内部查询当前正在执行环境的详细版本、编译器信息及处理器架构位数。
1. 单行终端命令执行内部打印
无需进入交互式 REPL 界面,直接使用 -c 参数即可输出精准信息:
# 打印详细版本(含构建日期与编译器版本)
python3 -c "import sys; print(sys.version)"
# 仅输出干净的版本数字符串(如 3.11.8)
python3 -c "import platform; print(platform.python_version())"
# 确认当前 Python 是 64 位还是 32 位架构
python3 -c "import struct; print(struct.calcsize('P') * 8)"
2. 虚拟环境(venv / virtualenv)中的版本确认
当一个项目使用了专属虚拟环境时,只要先激活该虚拟环境,环境内部的 bin(Mac)或 Scripts(Windows)目录就会被临时插入到当前终端 PATH 环境变量的最前端:
- Windows 激活后:执行
where python,第一条路径将显示为项目目录下的.venv\Scripts\python.exe; - macOS 激活后:执行
which python3或which python,路径将显示为/Users/.../myproject/.venv/bin/python。
在激活状态下,直接使用 python -V 即可准确获知当前虚拟环境锁定的 Python 版本,而不会受到宿主机系统全局默认版本变更的影响。
五、常见问题排查与版本判断决策
在执行版本查询时,读者最常遇到的三类问题及应对策略如下:
-
报错“command not found: python”或“不是内部或外部命令”:
证明系统 PATH 中没有名为python的可执行文件。在 Mac 下请统一换用python3 --version;在 Windows 下建议直接使用py --version,或重新打开安装程序勾选“Add python.exe to PATH”。 -
明明安装了 Python 3.12,查询结果依然显示旧版本 3.9:
这是典型的环境变量优先级顺序问题。系统在查找可执行文件时,按照PATH中从上到下的顺序搜索,先匹配到的目录会遮蔽后面的版本。Mac 用户可用type -a python3查出所有路径,并调整~/.zshrc中的export PATH=...顺序;Windows 用户可用where python查出位置,在“系统属性 > 环境变量 > Path”中将期望的版本目录上移至最顶部。 -
Windows 下运行 python 自动打开 Microsoft Store:
系统命中了 Windows 自带的别名占位符。关闭方法:开始菜单打开“设置” > 搜索“应用执行别名” > 将与 Python 相关的两个开关置为“关”。
六、常用命令速查汇总表
为便于日常开发随时查阅,下表总结了 Windows 与 Mac 系统中最为常用的版本查询及关联排查命令:
| 查询目的 | Windows 常用命令 | macOS 常用命令 | 说明与建议 |
|---|---|---|---|
| 快速查看默认版本 | python --version 或 py -V |
python3 --version 或 python3 -V |
优先使用大写 -V 参数,避免小写 -v 进入详细模式 |
| 列出所有已装版本 | py -0 或 py --list |
brew list --versions python |
Windows 的 py 启动器自带版本枚举能力 |
| 查询执行文件路径 | where python |
which python3 |
用于确认是否命中虚拟环境或系统目录 |
| 列出所有路径优先级 | where /r C:\ python.exe |
type -a python3 |
排查多版本遮蔽问题 |
| 脚本内精确获取版本 | python3 -c "import platform; print(platform.python_version())" |
跨平台完全一致,输出纯数字版本字符串 | |
| 获取编译器与构建详情 | python3 -c "import sys; print(sys.version)" |
包含 GCC/Clang 编译版本及 64/32 位架构标识 | |
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









