了解自己使用的 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 开发者职业路径,学习网页爬虫、软件包开发中的测试与版本控制。
了解自己使用的 Python 版本比您想象的更重要。许多库和框架依赖特定的 Python 版本,不同版本之间代码的行为也会有所差异。在不受支持或与预期不符的版本上运行脚本,往往会导致安装失败或难以排查的运行时错误。
在本指南中,我将带您通过简单且可靠的方法,在常见操作系统、环境和设置中检查您的 Python 版本。如果您刚开始学习 Python,建议您学习我们的Python 入门课程,涵盖数据类型、列表、基础函数和软件包等技能。
如何在命令行查看 Python 版本
检查 Python 版本最常见的方法是使用您电脑的终端(Mac/Linux)或命令提示符/PowerShell(Windows)。
使用 python --version
该命令会查询系统中与 python 命令关联的解释器,并打印其版本信息。
如果
python已正确配置到您的 PATH 上,此命令在大多数系统上都能正常工作。不过,如果python指向 Python 2,或 PATH 中不存在该命令,则可能失败。使用 python3 --version
某些系统(尤其是 macOS 和 Linux)需要使用
python3来明确引用 Python 3。这是因为大多数现代计算机同时包含 Python 2 和 Python 3。在 Windows 上,除非安装 Python 时显式添加了
python3,否则此命令可能无法使用。使用 python -V(替代语法)
该命令是
python --version的简写形式。该命令会产生相同的输出,但在某些环境中的行为略有不同。在一些较旧的环境或特定 shell 中,版本号可能会被发送到
stderr(标准错误)而不是stdout(标准输出)。对人眼来说,屏幕显示看起来一样,但如果您在脚本中尝试将该文本“管道”到另一个文件或程序时,这一点就会产生影响。
如何在 Python 内部查看版本
有时,您可能希望在脚本或交互式会话中查看 Python 版本。当您希望代码确认其运行时环境、以便帮助调试脚本问题时,这很有用。
您可以通过导入内置的
sys库来获取版本详细信息。下面的代码会显示完整的 Python 版本字符串及其构建细节。当您编写依赖 Python 版本的条件逻辑并记录运行时信息时,此方法非常实用。
在虚拟环境中检查 Python 版本
由于虚拟环境(
venv和conda)用于特定项目,它们使用的 Python 版本可能与系统默认版本不同。如果您创建了虚拟环境,它会自带特定的 Python 解释器,激活该环境会切换所使用的 Python 可执行文件。要确认虚拟环境中的活动 Python 版本,请先激活该环境,然后运行以下命令:
如果显示的版本与您的预期不符,可能是该环境是用不同的 Python 安装创建的,或当前未被激活。
当您需要快速了解如何管理软件包和使用 conda 环境时,我建议使用我们的Conda 速查表。
如何在不同操作系统上查看 Python 版本
不同操作系统对 Python 的处理略有差异。以下是各系统中的查看方法:
Windows
在 Windows 中,您可以使用:
或:
这种方法的不足在于,多个 Python 安装可能引发混淆,或者由于 PATH 配置错误而无法识别
python。此外,py启动器可能指向与python不同的版本,从而导致失败。macOS 和 Linux
在 macOS 和 Linux 中,您需要注意系统可能包含供操作系统内部使用的预装 Python。此外,
python可能指向 Python 2,或者根本不存在,而python3通常指向用户安装的 Python 3 版本。您可以在 macOS 或 Linux 中使用以下命令检查 Python 版本:
或者使用
python3,以避免误用过时或由系统管理的 Python。检查 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 开发者职业路径,学习网页爬虫、软件包开发中的测试与版本控制。