Python代码中怎么获取当前运行环境的版本号？

在编写Python程序或开发第三方库时，我们常常需要根据当前解释器的版本执行不同逻辑，或者在系统日志中记录运行环境。获取Python版本号的核心解答非常明确：如果需要在代码中做版本判断或条件分支，最稳妥的方法是使用标准库内置的 sys.version_info；如果仅需向用户展示易读的版本字符串或记录到日志文件，最便捷的方式是使用 platform.python_version()。本文将具体介绍这些标准方法的使用步骤、返回值结构以及版本比较时容易踩坑的细节。

一、用于逻辑判断的最佳实践：sys.version_info

在实际开发中，获取版本号的最常见目的是检查运行环境是否满足当前代码的要求。例如，某些类型提示语法在 Python 3.10 及以上才受支持，如果运行在旧版本上，就需要采用降级方案。

标准库 sys 模块提供了 sys.version_info 对象。它是一个具名元组（named tuple），包含了版本号的各个组成部分，可以直接通过属性名或数字索引读取。

import sys

# 打印完整的具名元组
print(sys.version_info)

# 访问具体字段
print("主版本号:", sys.version_info.major)
print("次版本号:", sys.version_info.minor)
print("修订号:", sys.version_info.micro)
print("发行级别:", sys.version_info.releaselevel)
print("序列号:", sys.version_info.serial)

示例输出：

sys.version_info(major=3, minor=11, micro=4, releaselevel='final', serial=0)
主版本号: 3
次版本号: 11
修订号: 4
发行级别: final
序列号: 0

如何编写版本检查分支？

由于 sys.version_info 本质上是元组，Python 会自动按照元组中元素从左到右的顺序逐项进行整数大小比较。因此，编写版本兼容检查代码时，只需直接与目标元组比较即可：

import sys

if sys.version_info >= (3, 10):
    print("当前运行在 Python 3.10 或更高版本，可使用新式语法")
else:
    print("当前运行在旧版本 Python，启用向下兼容实现")

这种写法简洁且绝不会出错，不论次版本号是一位数还是两位数，都能准确判定。

二、版本比较中的经典陷阱：字符串字典序

许多初学者或从其它语言转来的开发者容易编写类似下面的代码：直接获取版本字符串，或者切片前几位进行字符串比较。这种写法在特定历史阶段“看似有效”，但隐藏着严重逻辑错误。

三、用于展示与记录的字符串方法

当需求不是做代码逻辑分支，而是向用户展示软件当前运行的环境，或者在日志记录中输出一条清晰的版本标识时，有以下几种常用方式。

1. platform.python_version()：获取纯净版本字符串

platform 是专门用于获取操作系统和运行环境信息的标准库模块。它的 python_version() 函数能够直接返回 'major.minor.micro' 格式的标准版本号字符串，没有任何多余的附加文字，非常适合放在前端界面或控制台标题中。

import platform

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

示例输出：

当前Python版本: 3.11.4

2. platform.python_version_tuple()：获取字符串元组

如果希望以字符串列表或元组的形式分别获取三个版本层级，可以使用 platform.python_version_tuple()：

import platform

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

示例输出：

主版本: 3, 次版本: 11, 补丁: 4

3. sys.version：获取包含编译环境的完整信息

sys.version 属性返回的是一个较长的多行字符串，第一行通常是版本号，后面跟随编译器的版本以及构建日期。在处理用户提交的错误报告（Bug Report）或崩溃诊断日志时，这些信息能帮助准确定位具体使用的解释器构建版本。

import sys

print(sys.version)

示例输出：

3.11.4 (v3.11.4:d2340ef257, Jun  6 2023, 19:15:43) [Clang 13.0.0 (clang-1300.0.29.30)]

四、区分当前脚本的解释器与全局命令

另一个容易引起混淆的现实问题是：读者在系统终端执行 python --version 显示的是一个版本，而运行 Python 脚本时内部打印出的却是另一个版本。

这是因为操作系统中可以同时安装多个 Python 解释器（例如系统自带的 Python、Homebrew/apt 安装的版本、Conda 环境或虚拟环境 venv）。通过在代码中读取 sys.executable，可以查看当前正在执行该脚本的解释器绝对路径：

import sys

print("当前执行的解释器路径:", sys.executable)
print("当前解释器版本号:", sys.version_info[:3])

当遇到版本不一致的疑问时，先通过 sys.executable 查看实际使用的解释器路径，通常就能立刻明白是哪个环境生效了。

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

为了便于在实际开发中快速选用最合适的方法，下表将常用方法的使用场景及特点进行了归纳：

总结起来，在 Python 代码中获取环境版本号时牢记两条规则即可：做逻辑判断用 sys.version_info，给人看文字用 platform.python_version()。遵循这一准则，既能保证代码在新旧版本演进时的健壮性，也能用最少、最清晰的代码实现环境检测。