怎么验证Python是否安装成功及查看版本号

一、准备工作：打开操作系统的命令行终端

验证Python的前提是进入系统的命令行界面。不同操作系统打开终端的方式如下：

• Windows 系统：按下键盘上的快捷键 Win + R，在弹出的“运行”窗口中输入 cmd 或 powershell 并回车；也可以在开始菜单搜索“命令提示符”或“PowerShell”打开。
• macOS 系统：按下 Command + 空格键 唤起聚焦搜索（Spotlight），输入 Terminal 或“终端”并回车打开。
• Linux 系统：桌面环境下通常可以使用快捷键 Ctrl + Alt + T 快速调出终端，或在应用程序菜单中找到“Terminal”。

二、核心验证命令与版本号查看方法

在打开的终端光标后，依次尝试以下命令进行验证：

方法 1：使用标准 version 参数（最常用）

输入以下命令并按下回车：

python --version

或者使用大写的简写参数 -V（注意必须是大写，小写 -v 是开启详细追踪模式）：

python -V

如果安装成功，终端将立即返回类似如下格式的文本：

Python 3.12.3

方法 2：使用明确指定大版本的 python3 命令

在 macOS 和主流 Linux 发行版中，系统可能默认没有建立名为 python 的软链接，或者 python 指向的是历史遗留的旧版本。此时推荐直接执行：

python3 --version
# 或
python3 -V

若正常输出了形如 Python 3.11.8 的内容，同样代表 Python 3 已经就绪。

方法 3：Windows 专属的启动器命令（py）

Windows 官方安装包从 3.3 版本起内置了 Python Launcher（即 py.exe），它位于系统通用目录 C:\Windows\ 下。即便未手动配置 PATH 环境变量，通常也能直接运行：

py --version

此外，使用 py -0（数字 0）可以列出当前系统里安装的所有 Python 版本，这对于排查电脑中是否装了多个 Python 实例非常有效：

Installed Pythons found by py Launcher for Windows
 -3.12-64 *
 -3.10-64

方法 4：进入交互式解释器环境查看

直接在终端中敲入 python 或 python3 并按回车。如果安装无误，终端会从外部命令行切换为 Python 的交互式控制台，最上方会显示完整的构建版本、编译日期与架构信息：

Python 3.12.3 (tags/v3.12.3:f6650f9, Apr  9 2024, 14:05:25) [MSC v.1938 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> 

在出现 >>> 提示符后，可以运行内置模块查看更精准的版本元数据：

>>> import sys
>>> print(sys.version)
3.12.3 (tags/v3.12.3:f6650f9, Apr  9 2024, 14:05:25) [MSC v.1938 64 bit (AMD64)]
>>> exit()

三、原理解析：系统为什么能识别 Python 命令？

很多初学者会疑惑：为什么在命令行输入 python，系统就能找到刚刚安装的软件？

当我们在终端敲入任意命令时，操作系统并不会全盘扫描硬盘，而是按照系统环境变量 PATH（路径列表）中记录的文件夹顺序，由前至后逐一查找是否存在名为 python.exe（Windows）或名为 python / python3（Unix-like）的可执行文件：

1. 终端接收到用户输入的 python 命令。
2. 系统读取环境变量 PATH 中定义的一组目录（例如 C:\Program Files\Python312\ 或 /usr/local/bin）。
3. 一旦在某个目录中命中了对应的可执行文件，系统立即启动该程序并将控制权交出。
4. 如果遍历了所有配置好的路径都没有找到该文件，系统就会抛出“未找到命令”或“不是内部或外部命令”的提示。

四、常见验证异常及排查方案

如果在执行上述命令时未看到正确的版本号，通常属于以下几种典型情况：

1. 提示“'python' 不是内部或外部命令，也不是可运行的程序”

这是 Windows 用户最常遇到的问题。产生该现象的核心原因是在运行安装包时，没有勾选第一屏底部的 “Add python.exe to PATH”（添加 Python 到环境变量）。

解决步骤：

• 重新双击打开 Python 官方安装包（python-3.x.x-amd64.exe）。
• 在弹出面板中点击 Modify（修改），一路 Next 到“Advanced Options”界面。
• 务必勾选 “Add Python to environment variables”，然后点击 Install 完成修补。
• 关闭当前所有已经打开的 CMD 或 PowerShell 窗口，重新开启新终端窗口再次测试。

2. 输入 python 后直接打开了微软应用商店（Microsoft Store）

在 Windows 10/11 系统中，微软内置了名为“应用执行别名”的机制。如果系统 PATH 尚未生效，系统会优先调用系统默认占位符，触发商店弹窗。

解决步骤：

• 打开 Windows 系统的“设置”应用。
• 依次进入：应用 > 高级应用设置 > 应用执行别名。
• 在列表中找到名为 python.exe 和 python3.exe 的“应用安装程序”开关，将其全部切换为 关（Off）。
• 重新打开命令行窗口执行 python --version 即可。

3. 提示“command not found: python”但 python3 正常

在 macOS（特别是预装了新版本系统及 Xcode Command Line Tools 的机器）和部分 Linux 发行版中，操作系统为了避免与老旧 Python 2 冲突，移除了全局的 python 软链接，仅保留 python3。

解决步骤：直接在日常开发与脚本调用中统一使用 python3 和 pip3，或者在当前用户的 Shell 配置文件（如 ~/.zshrc 或 ~/.bashrc）中添加别名映射：alias python=python3。

五、单行代码实机测试与运行验证

除了只查看静态的版本号文本外，还可以直接利用 Python 的 -c 参数执行一段单行测试代码，以确保 Python 解释器和标准输出管道都能正常工作：

python -c "print('Python 环境验证成功！')"

如果使用的是 python3，则对应执行：

python3 -c "print('Python 环境验证成功！')"

当终端立即输出 Python 环境验证成功！ 且没有任何报错提示时，说明解释器不仅安装成功，而且具备了完整的代码解析与执行能力。

六、常用验证命令速查对照表

为便于日常快速查阅，下表汇总了验证 Python 与包管理器 pip 的高频命令：