怎么查看本地安装的Python版本？

一、终端命令行快速查看方法

命令行是查看 Python 版本最直接、最常用的入口。由于操作系统平台机制和历史遗留约定的差异，不同系统下的命令存在细微差别。

1. 通用查询命令

在任何终端中，最常见的通用命令如下：

你也可以使用简写形式 python -V（注意必须是大写字母 V）。参数大写 -V 与长参数 --version 完全等价。

2. macOS 与 Linux 平台的专属要求

在现代 macOS 与大多数 Linux 发行版（如 Ubuntu、Debian）中，系统已经移除了默认的 Python 2。按照 POSIX 社区标准，通过包管理器（如 Homebrew 或 apt）安装的 Python 解释器通常被命名为 python3。

因此，在 macOS 或 Linux 终端中，应首选执行：

如果在 macOS 上输入 python --version，系统可能会提示 zsh: command not found: python，或者弹窗提示安装 Xcode 开发者工具。这是正常现象，并不意味着你没有安装 Python，而是说明系统没有建立名为 python 的软链接。直接改用 python3 --version 即可。

3. Windows 平台的最佳实践：使用 py 启动器

在 Windows 官方安装包中，默认附带了一个轻量级管理工具——Python Launcher（启动器），可执行文件为 py.exe。它的优势在于能自动检索注册表，找到系统中最新安装的 Python 解释器，即使没有手动配置 PATH 环境变量也能正常工作。

若本地安装了多个 Python（例如同时装有 3.10 和 3.12），可以运行以下命令列出启动器检测到的所有版本及其物理安装位置：

输出中带星号（*）的行即代表当前默认启动的版本。

二、容易混淆的现象：为什么输出的版本与预期的不一致？

初学者在查看版本时经常遇到一种疑惑：“我刚刚明明从官网下载安装了最新的 Python 3.12，为什么在命令行输入 python --version，显示的却是 Python 3.9，甚至直接打开了 Windows 应用商店？”

这种现象看似矛盾，实际上是因为操作系统的环境变量搜索机制（PATH）在起作用。

1. PATH 环境变量的“首位命中”机制

当你在终端输入 python 时，操作系统并不会遍历整块硬盘去寻找“最新发布的版本”，而是按照环境变量 PATH 中登记的文件夹列表，自上而下逐个查找。只要在前面的文件夹里找到了名为 python.exe 的文件，就会立即启动它并终止搜索。

因此：

• 如果你以前安装过 Anaconda、Miniconda、旧版 Python 或者某些内置 Python 的开发软件（如嵌入式工具链），它们的安装目录如果排在 PATH 变量的前面，新安装的 Python 就会被拦截。
• 在 Windows 10/11 中，微软预置了一个位于 WindowsApps 目录下的 python.exe 占位重定向程序。如果在安装 Python 时未勾选“Add python.exe to PATH”，由于没有在 PATH 前面添加实际解释器，系统就会命中该占位程序，从而弹出应用商店引导下载。

2. 确认当前调用的到底是哪个 Python

当怀疑版本不一致时，不要只看版本号，而应查看该命令对应的实际物理磁盘路径：

• Windows 系统：使用 where python 命令
• macOS / Linux 系统：使用 which python3 或 which -a python3 命令

在上述输出中，排在第一行的是 miniconda3 下的解释器，这解释了为什么运行 python --version 得到的是 Conda 的版本，而不是新装的 Python 3.12。要解决此问题，只需在系统环境变量设置中，将目标版本的路径上移到最上方，或者直接使用虚拟环境。

三、在代码与交互式解释器中查看版本

在很多开发场景下，我们并不在命令行查看版本，而是需要在 Python 代码运行过程中动态获取当前解释器版本，例如校验依赖库的最低版本要求，或者记录程序启动日志。Python 标准库内置了两个专门的模块用于此任务。

1. 使用 sys 模块

sys 模块提供了底层运行时的具体细节，常用属性有两个：sys.version 和 sys.version_info。

在进行代码版本兼容性拦截时，绝不要对 sys.version 字符串做正则或切片比对，而应当直接使用 sys.version_info 元组进行逻辑大小比较：

2. 使用 platform 模块

如果你只需要一个清爽、纯粹的版本号字符串（例如 "3.12.2"），标准库中的 platform.python_version() 是最简洁的选择：

四、虚拟环境与特定场景下的版本确认

在实际项目开发中，通常推荐为每个项目创建独立的虚拟环境。在虚拟环境中，查看版本的方法虽然相同，但作用域发生了变化。

1. venv / virtualenv 虚拟环境

在激活虚拟环境后（例如 Windows 下执行 .venv\Scriptsctivate，或 macOS/Linux 下执行 source .venv/bin/activate），终端提示符通常会出现 (.venv) 前缀。

激活状态下，虚拟环境的 bin 或 Scripts 目录会被临时注入到当前终端环境变量 PATH 的最顶端。此时直接运行 python -V，输出的就是该虚拟环境绑定的 Python 版本。

2. Conda 环境版本查看

如果你使用的是 Anaconda 或 Miniconda，可以使用 Conda 工具链查看当前及所有已创建环境的 Python 版本：

• 查看当前激活环境的 Python 版本：python -V 或 conda list python
• 查看所有已安装的环境列表及路径：conda info --envs

五、全流程总结与排查决策

为了在遇到问题时能够快速定位，下表总结了不同场景下的首选查看方式，并附带故障排查决策图：