Python脚本中怎么获取当前运行版本号

在编写跨环境运行的脚本或维护公共工具库时，准确获取当前执行环境的Python版本号是一项基础需求。核心做法非常直接：如果你的目的是在日志或界面中打印展示，推荐使用标准库 platform.python_version() 或 sys.version；如果你的目的是在代码中做条件分支和兼容性判断，则必须使用结构化的命名元组 sys.version_info。本文将结合实际代码与常见陷阱，具体说明这几种方式的差异与使用规范。

获取版本号的核心方法与场景

Python的标准库内置了两个专门提供解释器信息的模块：sys 与 platform。很多初学者常把它们返回的内容混淆，导致在后续逻辑中写出不稳健的代码。这两种模块处理版本信息的侧重点完全不同。

图1：Python三个核心版本获取接口的特征与定位对比

1. 使用 sys 模块

sys 模块提供了底层系统参数。其中 sys.version 会返回解释器的完整标识信息，不仅有版本号，还附带编译器信息和构建时间戳；而 sys.version_info 返回的是结构化对象。

import sys

# 打印完整环境版本字符串
print("sys.version 输出:")
print(sys.version)

# 打印结构化版本对象
print("\nsys.version_info 输出:")
print(sys.version_info)

执行上述代码，得到的输出大致如下（环境不同细节会有差别）：

sys.version 输出:
3.11.8 (main, Feb  7 2024, 21:52:08) [Clang 13.0.0 (clang-1300.0.29.30)]

sys.version_info 输出:
sys.version_info(major=3, minor=11, micro=8, releaselevel='final', serial=0)

2. 使用 platform 模块

如果你只需要类似 "3.11.8" 这样干净的三段式字符串，platform.python_version() 是最省事的选择，不需要手工去截取 sys.version。

import platform

ver_str = platform.python_version()
ver_tuple = platform.python_version_tuple()

print(f"标准字符串: {ver_str}")
print(f"拆分元组: {ver_tuple}")

对应输出为：

标准字符串: 3.11.8
拆分元组: ('3', '11', '8')

深入拆解：sys.version_info 的内部结构

sys.version_info 是一个类元组对象（namedtuple）。它包含五个属性：major（主版本）、minor（次版本）、micro（修订版本）、releaselevel（发布状态）和 serial（发布序号）。它既支持通过属性名称访问，也支持像普通元组一样按索引访问或进行切片。

图2：sys.version_info 对象的字段构成及索引映射

在代码中提取特定层级的版本信息十分直接：

import sys

# 方式 A：通过字段名访问
major_ver = sys.version_info.major
minor_ver = sys.version_info.minor

# 方式 B：通过切片获取主次版本元组
main_pair = sys.version_info[:2]

print(f"主版本: {major_ver}, 次版本: {minor_ver}")
print(f"主次版本元组: {main_pair}")

版本比较的操作步骤与陷阱

获取版本号最常见的用途是版本门禁（Check & Gate），即如果当前环境版本低于某个要求，就报错退出或者执行兼容回退。这里最容易出现的严重逻辑漏洞是直接用字符串进行大小比较。

图3：版本检查与拦截的标准化执行流程

Python 元组天然支持字典序逐位比较。当比较两个元组时，解释器会先比较第一项，如果相等再比较第二项，以此类推。由于各项都是整型数值，因此能够精准反映版本高低。

下面是一个标准的脚本启动入口版本检查范例：

import sys

# 要求必须为 Python 3.10 及以上版本
MIN_VERSION = (3, 10)

if sys.version_info < MIN_VERSION:
    current_ver = f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
    sys.exit(
        f"[错误] 当前环境版本为 Python {current_ver}，"
        f"但该脚本依赖 Python {MIN_VERSION[0]}.{MIN_VERSION[1]} 或更高版本，程序已终止。"
    )

print("版本检查通过，正在继续执行业务逻辑...")

选型总结与使用清单

为了在实际开发中少走弯路，可以根据应用场景遵循以下选择依据：

图4：获取与使用 Python 版本号的决策总结

只要牢记“判断用元组，展示用字符”这条基本原则，就可以保证你的 Python 脚本在不同运行环境之间迁移时，具备严谨且可靠的版本兼容控制机制。