Python代码中获取当前运行版本号的方法

一、获取版本号的核心需求与选型流

Python提供了多个内置属性与函数用于读取版本信息。这些接口返回的数据结构各有不同，包括纯文本描述、精简版本号字符串、三元组以及具名元组。在编写具体代码前，首先需要明确获取版本号的实际目标：是用于向用户或日志输出展示，还是用于代码内部做版本阈值分支判断。

二、使用 sys 模块获取版本信息

sys 是Python的内置核心模块，无需单独安装第三方库即可直接导入。该模块提供了两个关键属性：sys.version 和 sys.version_info。

1. sys.version：包含编译信息的全量文本

sys.version 返回一个字符串，开头是主版本号、次版本号和修订号，随后附带构建编号、编译器标识以及构建日期。

import sys

# 打印完整的解释器版本信息
print("完整版本信息:")
print(sys.version)

该属性非常适合直接输出到系统日志（Log）中，便于运维人员排查跨环境问题。然而，由于它包含大量非数字的系统与编译器描述，不适合通过字符串截取来提取纯版本数字。

2. sys.version_info：结构化具名元组

如果需要结构化数据或进行逻辑判断，sys.version_info 是最官方、最规范的选择。它是一个 sys.version_info 类的实例，该类继承自内置元组（tuple），并提供了命名字段。

import sys

# 获取具名元组
v_info = sys.version_info

print("完整结构:", v_info)
print("主版本号 (major):", v_info.major)
print("次版本号 (minor):", v_info.minor)
print("修订号 (micro):", v_info.micro)
print("发布阶段 (releaselevel):", v_info.releaselevel)

三、使用 platform 模块获取格式化版本号

标准库 platform 模块专门用于探查运行平台及解释器的底层信息。如果希望直接拿到如 "3.11.5" 这样规整的标准三段式字符串，platform 提供了封装好的快捷函数。

1. platform.python_version()：标准版本字符串

该函数直接返回 major.minor.patchlevel 形式的字符串，排除了操作系统、构建时间等附加噪点。

import platform

ver_str = platform.python_version()
print("当前Python版本:", ver_str)

2. platform.python_version_tuple()：字符串拆分元组

如果需要将各段版本分离，可以使用 platform.python_version_tuple()，它返回由字符串构成的三元组：

import platform

major, minor, patch = platform.python_version_tuple()
print(f"主版本: {major}, 次版本: {minor}, 补丁: {patch}")

四、版本号比较的正确姿势与避坑

在实际项目中，获取版本号往往是为了判断“当前环境是否满足某特性所需的最低版本”。此处极易产生由字符串字典序导致的严重逻辑Bug。

五、实战场景：依据版本号动态执行代码

在实际项目维护中，常用模式是根据当前Python版本动态加载不同的标准库模块或选择性启用语法特性。以下是生产环境中常用的标准模版：

import sys

# 场景1：根据版本动态选择解析TOML配置的库
if sys.version_info >= (3, 11):
    # Python 3.11 及以上内置 tomllib
    import tomllib
    print("使用标准库内置 tomllib")
else:
    # Python 3.10 及更早版本使用第三方 tomli
    try:
        import tomli as tomllib
        print("使用兼容第三方库 tomli")
    except ImportError:
        raise RuntimeError("在 Python < 3.11 下运行本程序需要安装 tomli: pip install tomli")

# 场景2：严格限制运行环境不低于 3.8
MIN_PYTHON = (3, 8)
if sys.version_info < MIN_PYTHON:
    sys.exit(f"运行失败: 本程序需要 Python {MIN_PYTHON[0]}.{MIN_PYTHON[1]} 或更高版本，当前版本为 {sys.version.split()[0]}")

六、各方法横向对比与总结

为了便于在开发中快速检索与决策，我们将上述几种获取当前Python版本的方法总结归纳如下：