跳至主要内容

如何查看 Python 版本:Windows、macOS 和 Linux

了解如何在终端、脚本和虚拟环境中检查 Python 版本。掌握适用于 Windows、macOS 和 Linux 的常见问题与最佳实践。
· 6分钟 阅读

使用 AI 探索

了解自己使用的 Python 版本比您想象的更重要。许多库和框架依赖特定的 Python 版本,不同版本之间代码的行为也会有所差异。在不受支持或与预期不符的版本上运行脚本,往往会导致安装失败或难以排查的运行时错误。

在本指南中,我将带您通过简单且可靠的方法,在常见操作系统、环境和设置中检查您的 Python 版本。如果您刚开始学习 Python,建议您学习我们的Python 入门课程,涵盖数据类型、列表、基础函数和软件包等技能。

如何在命令行查看 Python 版本

检查 Python 版本最常见的方法是使用您电脑的终端(Mac/Linux)或命令提示符/PowerShell(Windows)。

使用 python --version

该命令会查询系统中与 python 命令关联的解释器,并打印其版本信息。

python --version

如果 python 已正确配置到您的 PATH 上,此命令在大多数系统上都能正常工作。不过,如果 python 指向 Python 2,或 PATH 中不存在该命令,则可能失败。

使用 python3 --version

某些系统(尤其是 macOS 和 Linux)需要使用 python3 来明确引用 Python 3。这是因为大多数现代计算机同时包含 Python 2 和 Python 3。

python3 --version

在 Windows 上,除非安装 Python 时显式添加了 python3,否则此命令可能无法使用。

使用 python -V(替代语法)

该命令是 python --version 的简写形式。

python -V

该命令会产生相同的输出,但在某些环境中的行为略有不同。在一些较旧的环境或特定 shell 中,版本号可能会被发送到 stderr(标准错误)而不是 stdout(标准输出)。

对人眼来说,屏幕显示看起来一样,但如果您在脚本中尝试将该文本“管道”到另一个文件或程序时,这一点就会产生影响。

如何在 Python 内部查看版本

有时,您可能希望在脚本或交互式会话中查看 Python 版本。当您希望代码确认其运行时环境、以便帮助调试脚本问题时,这很有用。

您可以通过导入内置的 sys 库来获取版本详细信息。下面的代码会显示完整的 Python 版本字符串及其构建细节。

-- Check Python version
import sys
print(sys.version)

当您编写依赖 Python 版本的条件逻辑并记录运行时信息时,此方法非常实用。

在虚拟环境中检查 Python 版本

由于虚拟环境(venv 和 conda)用于特定项目,它们使用的 Python 版本可能与系统默认版本不同。如果您创建了虚拟环境,它会自带特定的 Python 解释器,激活该环境会切换所使用的 Python 可执行文件。

要确认虚拟环境中的活动 Python 版本,请先激活该环境,然后运行以下命令:

python --version

如果显示的版本与您的预期不符,可能是该环境是用不同的 Python 安装创建的,或当前未被激活。

当您需要快速了解如何管理软件包和使用 conda 环境时,我建议使用我们的Conda 速查表。

如何在不同操作系统上查看 Python 版本

不同操作系统对 Python 的处理略有差异。以下是各系统中的查看方法:

Windows

在 Windows 中,您可以使用:

python --version

或:

py --version

这种方法的不足在于,多个 Python 安装可能引发混淆,或者由于 PATH 配置错误而无法识别 python。此外,py 启动器可能指向与 python 不同的版本,从而导致失败。

macOS 和 Linux

在 macOS 和 Linux 中,您需要注意系统可能包含供操作系统内部使用的预装 Python。此外,python 可能指向 Python 2,或者根本不存在,而 python3 通常指向用户安装的 Python 3 版本。

您可以在 macOS 或 Linux 中使用以下命令检查 Python 版本:

python --version

或者使用 python3,以避免误用过时或由系统管理的 Python。

python3 --version

检查 Python 版本时的常见问题

在检查 Python 版本时,您可能会遇到一些困惑,尤其是在涉及多个工具和环境时:

  • “找不到 Python 命令”:这通常意味着未安装 Python,或未将其加入系统 PATH。在某些系统上,只有 python3 可用,而没有 python。

  • 安装了多个 Python 版本:在同一台机器上安装多个 Python 版本很常见。python、python3 和 py 等不同命令可能指向不同的解释器,从而让版本检查看起来不一致。

  • 命令返回了意外的版本:您可能检查的是与预期不同的 Python 安装。这通常发生在未激活虚拟环境,或 PATH 顺序优先选择了另一个 Python 可执行文件时。

  • IDE 与终端版本不一致:您的 IDE(如 VS Code 或 PyCharm)可能被配置为使用与终端不同的 Python 解释器。IDE 内运行的代码使用其配置的解释器,未必与您在命令行中通过 python --version 得到的版本一致。

管理 Python 版本的最佳实践

为避免与版本相关的意外情况,建议参考以下清单:

  • 安装依赖前务必检查 Python 版本:在运行 pip install 等命令之前,先运行 python --version。这可确保您不会把库意外安装到错误的版本中。

  • 使用明确的命令:如果您确定需要 Python 3,请使用 python3,而不要假设 python 指向正确的版本。

  • 持续使用虚拟环境:每个新项目都使用虚拟环境(venv)。这能将项目的版本和库与系统其余部分隔离,确保各项目使用正确的 Python 版本和依赖。

  • 避免在项目中依赖系统自带的 Python:系统管理的 Python 往往被操作系统使用,应尽量保持原样。为项目单独安装一份 Python,以获得预期的结果。

结语

明确您正在运行的 Python 版本,能帮助您避免常见的环境配置问题,减少困惑,并在安装软件包或调试错误时节省时间。

若想系统学习 Python,您可以进一步了解我们的Python 数据基础和Python 编程基础技能路径。最后,我个人推荐我们的Python 开发者职业路径,学习网页爬虫、软件包开发中的测试与版本控制。

Allan Ouko

作者

Allan Ouko

数据科学技术写作者,具备数据分析、商业智能和数据科学的一线实践经验。我撰写以行业为导向的实用内容,涵盖 SQL、Python、Power BI、Databricks 和数据工程,并以真实的分析工作为基础。我的写作兼顾技术深度与业务影响,帮助专业人士将数据转化为自信的决策。

常见问题

检查 Python 版本最简单的方法是什么?

您可以在终端中运行 python --version 或 python3 --version 来检查 Python 版本。

为什么 python 显示的版本与 python3 不同?

如果您使用的是 macOS 或 Linux,python 和 python3 命令通常指向不同的 Python 安装。

为什么我的 IDE 显示的 Python 版本与终端不同?

IDE 使用自己配置的解释器,可能与系统或终端中的 Python 不一致。

“Python command not found” 是什么意思?

该提示通常表示未安装 Python,或未将其加入系统的 PATH。

我可以同时安装多个 Python 版本吗?

是的,您可以在同一台机器上同时安装多个 Python 版本。

主题