Python内置platform模块:访问底层平台的标识数据详解

itomcoil 2025-10-13 22:24 2 浏览

1. 模块概述

platform 模块是 Python 的一个内置模块，用于获取运行 Python 的底层平台的标识数据。它提供了跨平台的方式来访问系统信息，如操作系统、处理器、Python 版本等。该模块在需要根据运行环境进行不同处理的场景中非常有用，例如在不同操作系统上执行不同的代码路径。

2. 知识点

2.1 跨平台信息获取

2.1.1 platform.architecture()

功能: 查询给定的可执行文件（默认为 Python 解释器二进制码文件）来获取各种架构信息。

原型:

platform.architecture(executable=sys.executable, bits='', linkage='')

参数:

executable: 可执行文件路径，默认为当前 Python 解释器。
bits: 位架构，默认为空字符串。
linkage: 链接格式，默认为空字符串。

返回值: 返回一个元组 (bits, linkage)，包含可执行文件所使用的位架构和链接格式信息。

示例:

import platform
print(platform.architecture())

注意事项:

在 macOS 上，可执行文件可能是包含多种架构的通用文件。
更可靠的方式是查询 sys.maxsize 来判断是否为 64 位系统。

2.1.2 platform.machine()

功能: 返回机器类型，例如 'AMD64'。

原型:

platform.machine()

返回值: 返回机器类型字符串，如果无法确定则返回空字符串。

示例:

import platform
print(platform.machine())

2.1.3 platform.node()

功能: 返回计算机的网络名称。

原型:

platform.node()

返回值: 返回网络名称字符串，如果无法确定则返回空字符串。

示例:

import platform
print(platform.node())

2.1.4 platform.platform()

功能: 返回一个标识底层平台的字符串。

原型:

platform.platform(aliased=False, terse=False)

参数:

aliased: 是否使用平台别名，默认为 False。
terse: 是否只返回最小量信息，默认为 False。

返回值: 返回平台标识字符串。

示例:

import platform
print(platform.platform())

2.1.5 platform.processor()

功能: 返回处理器名称。

原型:

platform.processor()

返回值: 返回处理器名称字符串，如果无法确定则返回空字符串。

示例:

import platform
print(platform.processor())

2.1.6 platform.python_build()

功能: 返回 Python 编译代码和日期。

原型:

platform.python_build()

返回值: 返回一个元组 (buildno, builddate)。

示例:

import platform
print(platform.python_build())

2.1.7 platform.python_compiler()

功能: 返回编译 Python 的编译器信息。

原型:

platform.python_compiler()

返回值: 返回编译器信息字符串。

示例:

import platform
print(platform.python_compiler())

2.1.8 platform.python_branch()

功能: 返回 Python 实现的 SCM 分支。

原型:

platform.python_branch()

返回值: 返回 SCM 分支字符串。

示例:

import platform
print(platform.python_branch())

2.1.9 platform.python_implementation()

功能: 返回 Python 实现的字符串。

原型:

platform.python_implementation()

返回值: 返回 Python 实现字符串，如 'CPython'。

示例:

import platform
print(platform.python_implementation())

2.1.10 platform.python_revision()

功能: 返回 Python 实现的 SCM 修订版。

原型:

platform.python_revision()

返回值: 返回 SCM 修订版字符串。

示例:

import platform
print(platform.python_revision())

2.1.11 platform.python_version()

功能: 返回 Python 版本字符串。

原型:

platform.python_version()

返回值: 返回 Python 版本字符串，如 '3.13.0'。

示例:

import platform
print(platform.python_version())

2.1.12 platform.python_version_tuple()

功能: 返回 Python 版本元组。

原型:

platform.python_version_tuple()

返回值: 返回 Python 版本元组，如 ('3', '13', '0')。

示例:

import platform
print(platform.python_version_tuple())

2.1.13 platform.release()

功能: 返回系统的发布版本。

原型:

platform.release()

返回值: 返回系统发布版本字符串，如果无法确定则返回空字符串。

示例:

import platform
print(platform.release())

2.1.14 platform.system()

功能: 返回系统平台/OS 的名称。

原型:

platform.system()

返回值: 返回系统名称字符串，如 'Linux'。

示例:

import platform
print(platform.system())

2.1.15 platform.system_alias()

功能: 返回系统别名。

原型:

platform.system_alias(system, release, version)

参数:

system: 系统名称。
release: 系统发布版本。
version: 系统版本。

返回值: 返回系统别名元组 (system, release, version)。

示例:

import platform
print(platform.system_alias('Linux', '5.15.0', '20.04'))

2.1.16 platform.version()

功能: 返回系统的发布版本信息。

原型:

platform.version()

返回值: 返回系统版本信息字符串，如果无法确定则返回空字符串。

示例:

import platform
print(platform.version())

2.1.17 platform.uname()

功能: 返回包含系统信息的命名元组。

原型:

platform.uname()

返回值: 返回包含系统信息的命名元组。

示例:

import platform
print(platform.uname())

2.2 Java 平台信息

2.2.1 platform.java_ver()

功能: Jython 的版本接口。

原型:

platform.java_ver(release='', vendor='', vminfo=('', '', ''), osinfo=('', '', ''))

参数:

release: Java 版本。
vendor: Java 供应商。
vminfo: 虚拟机信息元组 (vm_name, vm_release, vm_vendor)。
osinfo: 操作系统信息元组 (os_name, os_version, os_arch)。

返回值: 返回一个元组 (release, vendor, vminfo, osinfo)。

示例:

import platform
print(platform.java_ver())

注意事项:

该模块在 Python 3.13 中已被弃用，将在 3.15 中移除。

2.3 Windows 平台信息

2.3.1 platform.win32_ver()

功能: 从 Windows 注册表获取额外的版本信息。

原型:

platform.win32_ver(release='', version='', csd='', ptype='')

参数:

release: OS 发行版。
version: 版本号。
csd: CSD 级别 (Service Pack)。
ptype: OS 类型。

返回值: 返回一个元组 (release, version, csd, ptype)。

示例:

import platform
print(platform.win32_ver())

2.3.2 platform.win32_edition()

功能: 返回当前 Windows 版本的字符串。

原型:

platform.win32_edition()

返回值: 返回 Windows 版本字符串，如果无法确定则返回 None。

示例:

import platform
print(platform.win32_edition())

2.3.3 platform.win32_is_iot()

功能: 判断当前 Windows 版本是否为 IoT 版。

原型:

platform.win32_is_iot()

返回值: 返回布尔值，表示是否为 IoT 版。

示例:

import platform
print(platform.win32_is_iot())

2.4 macOS 平台信息

2.4.1 platform.mac_ver()

功能: 获取 macOS 版本信息。

原型:

platform.mac_ver(release='', versioninfo=('', '', ''), machine='')

参数:

release: macOS 发布版本。
versioninfo: 版本信息元组 (version, dev_stage, non_release_version)。
machine: 机器类型。

返回值: 返回一个元组 (release, versioninfo, machine)。

示例:

import platform
print(platform.mac_ver())

2.5 iOS 平台信息

2.5.1 platform.ios_ver()

功能: 获取 iOS 版本信息。

原型:

platform.ios_ver(system='', release='', model='', is_simulator=False)

参数:

system: OS 名称。
release: iOS 版本号。
model: 设备型号标识符。
is_simulator: 是否为模拟器。

返回值: 返回一个命名元组，包含 iOS 版本信息。

示例:

import platform
print(platform.ios_ver())

2.6 Unix 平台信息

2.6.1 platform.libc_ver()

功能: 确定可执行文件所链接到的 libc 版本。

原型:

platform.libc_ver(executable=sys.executable, lib='', version='', chunksize=16384)

参数:

executable: 可执行文件路径。
lib: libc 名称。
version: libc 版本。
chunksize: 读取文件的分块大小。

返回值: 返回一个元组 (lib, version)。

示例:

import platform
print(platform.libc_ver())

2.7 Linux 平台信息

2.7.1 platform.freedesktop_os_release()

功能: 从 os-release 文件获取操作系统标识。

原型:

platform.freedesktop_os_release()

返回值: 返回一个字典，包含操作系统标识信息。

示例:

import platform
print(platform.freedesktop_os_release())

2.8 Android 平台信息

2.8.1 platform.android_ver()

功能: 获取 Android 设备信息。

原型:

platform.android_ver(release='', api_level=0, manufacturer='', model='', device='', is_emulator=False)

参数:

release: Android 版本。
api_level: API 级别。
manufacturer: 厂商名称。
model: 型号名称。
device: 设备名称。
is_emulator: 是否为模拟器。

返回值: 返回一个命名元组，包含 Android 设备信息。

示例:

import platform
print(platform.android_ver())

3. 知识导图

4. 应用案例

4.1 获取系统信息并打印示例

功能: 获取并打印当前系统的详细信息。

代码:

import platform

def get_system_info():
    info = {
        "System": platform.system(),
        "Node Name": platform.node(),
        "Release": platform.release(),
        "Version": platform.version(),
        "Machine": platform.machine(),
        "Processor": platform.processor(),
        "Python Version": platform.python_version(),
        "Python Implementation": platform.python_implementation(),
        "Python Compiler": platform.python_compiler(),
        "Python Build": platform.python_build(),
    }
    for key, value in info.items():
        print(f"{key}: {value}")

if __name__ == "__main__":
    get_system_info()

输出示例:

System: Linux
Node Name: my-computer
Release: 5.15.0-83-generic
Version: #92-Ubuntu SMP Tue Oct 3 09:00:00 UTC 2023
Machine: x86_64
Processor: AMD64
Python Version: 3.13.0
Python Implementation: CPython
Python Compiler: GCC 13.2.0
Python Build: ('default', 'Oct  3 2023 14:00:00')

4.2 判断系统是否为 64 位示例

功能: 判断当前系统是否为 64 位系统。

代码:

import platform
import sys

def is_64bit():
    return sys.maxsize > 2**32

if __name__ == "__main__":
    if is_64bit():
        print("This is a 64-bit system.")
    else:
        print("This is a 32-bit system.")