Python 文件大小的获取方法

冷炫風刃 2025-11-19 00:00:00 次阅读

使用os.path.getsize()和pathlib.Path.stat()可获取文件大小，前者简单直接，后者更现代；字节可转换为KB、MB等易读单位。

在 Python 中获取文件大小是一个常见的操作，通常用于判断文件是否为空、监控存储使用或进行文件上传限制等。最常用的方法是使用标准库中的 os.path.getsize() 和 pathlib.Path.stat() 方法。

使用 os.path.getsize() 获取文件大小

这是最简单直接的方式，适用于已知文件路径的情况。

该函数接受文件路径作为参数，返回文件的字节大小。如果文件不存在或无法访问，会抛出异常。

返回值单位是字节（bytes）
路径可以是相对路径或绝对路径
文件必须存在，否则引发 OSError

示例代码：

import os
file_path = 'example.txt'
try:
size_in_bytes = os.path.getsize(file_path)
print(f'文件大小：{size_in_bytes} 字节')
except OSError as e:
print(f'无法获取文件大小：{e}')

使用 pathlib 模块获取文件大小

Python 3.4+ 推荐使用 pathlib，它提供面向对象的文件系统路径操作方式。

通过调用 Path 对象的 .stat() 方法，可以获得包括文件大小在内的详细信息。

更现代、可读性强
支持跨平台路径处理
stat().st_size 返回字节大小

示例代码：

from pathlib import Path
file_path = Path('example.txt')
if file_path.exists():
size_in_bytes = file_path.stat().st_size
print(f'文件大小：{size_in_bytes} 字节')
else:
print('文件不存在')

将字节转换为更易读的单位

原始字节值对用户不够友好，可以通过简单函数转换为 KB、MB 或 GB。

实用转换函数：

def format_file_size(bytes_size):
    for unit in ['B', 'KB', 'MB', 'GB']:
        if bytes_size < 1024.0:
            return f"{bytes_size:.2f} {unit}"
        bytes_size /= 1024.0
    return f"{bytes_size:.2f} TB"
使用示例
size_in_bytes = 1572864  # 假设这是获取到的大小
print(format_file_size(size_in_bytes))  # 输出：1.50 MB