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

一、核心方法：使用 sys 模块获取版本信息

Python 的内置 sys 模块提供了与当前 Python 解释器及其环境直接交互的变量和函数。因为是内置模块，无需安装任何额外包即可开箱即用。通过 sys 模块，我们可以通过两个核心属性分别获取结构化版本和描述性文本。

1.1 sys.version_info：最适合做版本条件判断

sys.version_info 返回一个命名元组（named tuple），包含了 5 个主要字段：major（主版本号）、minor（次版本号）、micro（微版本号/修订号）、releaselevel（发布状态，如 'alpha', 'beta', 'candidate', 'final'）以及 serial（序列号）。

import sys

# 打印完整的命名元组对象
print(sys.version_info)
# 示例输出：sys.version_info(major=3, minor=10, micro=8, releaselevel='final', serial=0)

# 单独提取具体字段
print(f"主版本: {sys.version_info.major}")
print(f"次版本: {sys.version_info.minor}")
print(f"修订号: {sys.version_info.micro}")

由于 sys.version_info 本质上支持元组比较，Python 会按照元素位置逐一比对整数值。这意味着开发者可以直接使用比较运算符判断当前环境是否满足脚本运行的最低版本要求：

import sys

# 校验当前环境是否至少为 Python 3.8
if sys.version_info >= (3, 8):
    print("当前环境满足 Python 3.8+ 要求，继续执行。")
else:
    print("错误：本脚本需要 Python 3.8 或更高版本。")

1.2 sys.version：适合记录详细日志与环境诊断

sys.version 返回一个字符串，除了包含基本的“主.次.微”版本号外，还包含了解释器的构建编号、编译日期以及所使用的编译器类型。

import sys

print(sys.version)
# 示例输出：
# 3.10.8 (main, Oct 11 2022, 19:15:39) [GCC 11.3.0]

由于该字符串格式较长且因操作系统与编译工具链而异，通常不应通过解析该字符串来做版本判断，但非常适合在应用程序启动时写入系统日志，便于后续问题溯源。

二、在脚本中做环境检查的标准实践步骤

在实际项目工程中，许多脚本用到了较新版本才支持的语法特性（例如 Python 3.9 的字典合并运算符 |，或者 Python 3.10 的 match-case 结构）。若脚本在旧版本解释器中直接运行，可能会在解析阶段或执行途中报出 SyntaxError 或异常退出。

为了提供清晰友好的错误指引，建议在脚本的最顶部执行标准的环境拦截步骤。

2.1 完整可运行代码示例

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
脚本环境兼容性前置检查示例
"""
import sys

def check_python_environment(min_major=3, min_minor=8):
    """
    检查当前 Python 运行环境是否满足最低版本限制
    """
    current_version = sys.version_info
    required_version = (min_major, min_minor)
    
    # 使用元组直接比较
    if current_version < required_version:
        sys.stderr.write(
            f"[错误] 当前 Python 环境版本过低: {current_version.major}.{current_version.minor}.{current_version.micro}\n"
            f"[提示] 该脚本需要 Python {min_major}.{min_minor} 或更高版本，请升级或激活对应虚拟环境。\n"
        )
        sys.exit(1)

# 在执行其他业务逻辑前优先执行环境检查
check_python_environment(3, 8)

print("环境校验通过，开始执行主要业务任务...")

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

除了 sys 模块，Python 标准库中的 platform 模块专门用于探查底层系统平台与运行环境的软硬件特征。它提供了几个非常易读的获取版本号的函数。

3.1 platform.python_version()：获取纯净字符串

platform.python_version() 返回一个精简的标准三段式版本号字符串，如 '3.10.8' 或 '3.11.2'。没有任何额外的编译器或环境说明文字。

import platform

ver = platform.python_version()
print(f"当前运行环境版本: {ver}")
# 示例输出：当前运行环境版本: 3.10.8

当你需要编写命令行工具的 --version 输出，或者将版本号写入 UI 界面、网页页脚时，这个函数是最省事的选择，不需要做任何字符串切片处理。

3.2 platform.python_version_tuple()：字符串形式的三元组

platform.python_version_tuple() 会返回一个由主版本、次版本、修订号组成的字符串元组。例如 ('3', '10', '8')。

import platform

major, minor, patch = platform.python_version_tuple()
print(f"主: {major}, 次: {minor}, 补丁: {patch}")
# 示例输出：主: 3, 次: 10, 补丁: 8

四、关键细节与避坑指南：切勿使用字符串做版本比对

在初学者编写的脚本中，经常出现一种隐蔽的 Bug：试图通过字符串切片或直接比较字符串来验证版本。这一做法在 Python 3.9 及更早版本时可能看似能正常运行，但在进入 Python 3.10 时代后会彻底失效。

4.1 字典序比较导致的致命逻辑缺陷

在 Python 中，字符串的比对是按照字符的 ASCII/Unicode 字典序自左至右逐字符进行的，并不是比较数字的大小：

# 错误的做法：直接比较字符串
current_ver = "3.10.4"
required_ver = "3.8"

# 字典序判定：'3'等于'3'，'.'等于'.'，紧接着比对下一个字符：
# '1' 的 ASCII 值为 49，'8' 的 ASCII 值为 56
# 因为 '1' < '8'，所以 "3.10.4" < "3.8" 的结果竟然是 True！
print(current_ver >= required_ver)  # 输出：False！

如果脚本使用 str >= "3.8" 作为拦截条件，那么在更新、功能更强大的 Python 3.10、3.11 或 3.12 环境下运行时，系统反而会错误地判定环境“版本不足”而退出！

五、综合场景总结与选择指南

为了让读者在实际编写代码时能够快速决策，下表归纳了不同方式的核心属性与推荐场景：

总结而言，在 Python 脚本中获取当前运行环境版本号时：做条件分支判定务必使用 sys.version_info，需要规范字符串展示时选用 platform.python_version()，而排查日志归档使用 sys.version。掌握这三者的定位与机制，就能在各类工程场景下安全、规范地处理 Python 运行环境的版本管理。