python如何获得文件大小

Python获取文件大小的几种方法包括：os.path.getsize()、os.stat()、pathlib.Path().stat().st_size。其中，os.path.getsize() 是最常用的方法，使用简单且功能强大。下面将详细描述这种方法。

使用 os.path.getsize() 获取文件大小非常简单。首先，导入 os 模块，然后使用 os.path.getsize() 函数传入文件路径即可获得文件的大小。此方法返回文件大小的字节数，可以通过简单的数学运算将其转换为KB、MB或GB等更易读的单位。

一、使用os.path.getsize()方法

os.path.getsize() 方法是最常用且直观的方法。它的使用方法如下：

import os
file_path = 'example.txt'
file_size = os.path.getsize(file_path)
print(f"文件大小: {file_size} 字节")

这个方法非常直观，只需传入文件路径即可获得文件大小。

优点：

简单易用：只需一行代码即可获得文件大小。
跨平台支持：无论是Windows、Linux还是macOS，都可以使用此方法。

缺点：

文件路径有效性：如果文件路径无效或文件不存在，会抛出 OSError 异常。

二、使用os.stat()方法

os.stat() 方法提供了更详细的文件信息，包括文件大小、权限、创建时间等。可以通过 st_size 属性获取文件大小。

import os
file_path = 'example.txt'
file_info = os.stat(file_path)
file_size = file_info.st_size
print(f"文件大小: {file_size} 字节")

优点：

详细信息：除了文件大小，还可以获取文件的其他详细信息。
高效：适用于需要获取多项文件属性的场景。

缺点：

稍复杂：相比 os.path.getsize()，代码稍微复杂一些。

三、使用pathlib.Path().stat().st_size方法

pathlib 是Python 3.4引入的模块，提供了面向对象的路径操作接口。通过 Path 对象的 stat() 方法可以获取文件信息，并通过 st_size 属性获取文件大小。

from pathlib import Path
file_path = Path('example.txt')
file_size = file_path.stat().st_size
print(f"文件大小: {file_size} 字节")

优点：

面向对象：代码更具可读性，适合现代Python编程风格。
丰富的路径操作：Path对象提供了丰富的路径操作方法。

缺点：

Python版本限制：仅适用于Python 3.4及以上版本。

四、不同方法的对比和实际应用场景

1. 适用场景

os.path.getsize()：适用于简单的文件大小获取，不需要其他文件属性的场景。
os.stat()：适用于需要获取文件的多项属性，如文件创建时间、权限等。
pathlib.Path().stat().st_size：适用于现代Python编程，尤其是需要进行复杂路径操作的场景。

2. 性能比较

在大多数情况下，三种方法的性能差异不大，都是通过系统调用获取文件信息。但是在需要获取多项文件属性时，os.stat() 和 pathlib.Path().stat() 可能会更高效。

五、错误处理

在实际应用中，获取文件大小时需要考虑文件路径的有效性和文件是否存在等问题。以下是一个完整的示例，包含错误处理：

import os
def get_file_size(file_path):
    try:
        file_size = os.path.getsize(file_path)
        return file_size
    except OSError as e:
        print(f"获取文件大小失败: {e}")
        return None
file_path = 'example.txt'
file_size = get_file_size(file_path)
if file_size is not None:
    print(f"文件大小: {file_size} 字节")

六、文件大小的单位转换

文件大小通常以字节为单位，但在显示时我们更习惯使用KB、MB或GB等单位。以下是一个简单的单位转换函数：

def convert_size(size_bytes):
    if size_bytes == 0:
        return "0B"
    size_name = ("B", "KB", "MB", "GB", "TB")
    i = int(math.floor(math.log(size_bytes, 1024)))
    p = math.pow(1024, i)
    s = round(size_bytes / p, 2)
    return f"{s} {size_name[i]}"
file_size = get_file_size(file_path)
if file_size is not None:
    print(f"文件大小: {convert_size(file_size)}")

这个函数将字节数转换为更易读的单位，并保留两位小数。

七、实际案例分析

假设你在开发一个文件上传系统，需要在用户上传文件时显示文件大小，并限制上传文件的大小。以下是一个实际案例的示例代码：

import os
def get_file_size(file_path):
    try:
        file_size = os.path.getsize(file_path)
        return file_size
    except OSError as e:
        print(f"获取文件大小失败: {e}")
        return None
def convert_size(size_bytes):
    if size_bytes == 0:
        return "0B"
    size_name = ("B", "KB", "MB", "GB", "TB")
    i = int(math.floor(math.log(size_bytes, 1024)))
    p = math.pow(1024, i)
    s = round(size_bytes / p, 2)
    return f"{s} {size_name[i]}"
def check_file_size(file_path, max_size_mb):
    file_size = get_file_size(file_path)
    if file_size is None:
        return False
    max_size_bytes = max_size_mb * 1024 * 1024
    if file_size > max_size_bytes:
        print(f"文件大小超过限制: {convert_size(file_size)}")
        return False
    print(f"文件大小: {convert_size(file_size)}")
    return True
file_path = 'example.txt'
max_size_mb = 10  # 限制上传文件大小为10MB
if check_file_size(file_path, max_size_mb):
    print("文件大小符合要求，可以上传")
else:
    print("文件大小超出限制，无法上传")

在这个示例中，check_file_size 函数用于检查文件大小是否超过限制，并在控制台打印文件大小信息。如果文件大小符合要求，则允许上传，否则拒绝上传。

八、总结

获取文件大小是文件操作中常见的需求，Python 提供了多种方法来实现这一功能。os.path.getsize() 是最常用的方法，简单易用；os.stat() 提供了更详细的文件信息，适用于需要获取多项文件属性的场景；pathlib.Path().stat().st_size 则适合现代Python编程风格。

在实际应用中，选择合适的方法可以提高代码的可读性和维护性，同时需要注意文件路径的有效性和错误处理。通过单位转换函数，可以将文件大小以更易读的形式显示，提升用户体验。在开发文件上传系统等实际项目时，结合具体需求选择合适的方法，确保系统的稳定性和可靠性。