Windows和Mac下怎么查Python版本?常见命令汇总

巷口听风
巷口听风
发布时间:2026-11-17 | 4人浏览过
原创

全面汇总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和Mac下怎么查Python版本?常见命令汇总
图1:终端查看 Python 版本的推荐操作流程与回退路径

二、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)”开关关闭。

Windows和Mac下怎么查Python版本?常见命令汇总
图2:Windows 系统下 Python Launcher (py) 路由分发机制

三、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
Windows和Mac下怎么查Python版本?常见命令汇总
图3:Windows 与 macOS 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 版本,而不会受到宿主机系统全局默认版本变更的影响。

五、常见问题排查与版本判断决策

在执行版本查询时,读者最常遇到的三类问题及应对策略如下:

  1. 报错“command not found: python”或“不是内部或外部命令”:
    证明系统 PATH 中没有名为 python 的可执行文件。在 Mac 下请统一换用 python3 --version;在 Windows 下建议直接使用 py --version,或重新打开安装程序勾选“Add python.exe to PATH”。
  2. 明明安装了 Python 3.12,查询结果依然显示旧版本 3.9:
    这是典型的环境变量优先级顺序问题。系统在查找可执行文件时,按照 PATH 中从上到下的顺序搜索,先匹配到的目录会遮蔽后面的版本。Mac 用户可用 type -a python3 查出所有路径,并调整 ~/.zshrc 中的 export PATH=... 顺序;Windows 用户可用 where python 查出位置,在“系统属性 > 环境变量 > Path”中将期望的版本目录上移至最顶部。
  3. Windows 下运行 python 自动打开 Microsoft Store:
    系统命中了 Windows 自带的别名占位符。关闭方法:开始菜单打开“设置” > 搜索“应用执行别名” > 将与 Python 相关的两个开关置为“关”。
Windows和Mac下怎么查Python版本?常见命令汇总
图4: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 位架构标识
相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表