os.path.getsize()获取文件大小详解 - Python文件空间分析教程

一、os.path.getsize() 概述

在文件管理和系统运维中，获取文件大小是一个非常常见的需求。os.path.getsize() 函数提供了一种快速且无需打开文件的方式，直接返回指定文件的字节大小。

无论是文件上传校验、磁盘空间分析、还是日志文件监控，掌握这个函数都能让你的文件处理代码更加简洁高效。它底层调用操作系统的 stat() 系统调用，性能非常优秀。

二、语法与参数说明

语法

os.path.getsize(path)

参数说明

返回值

返回文件大小，以字节（bytes）为单位，类型为 int。如果文件不存在或无法访问，将抛出 OSError 异常。

三、代码示例详解

示例 1：获取文件大小并转换为常用单位

os.path.getsize() 返回的是字节数，通常需要转换为 KB、MB 等人类可读的单位：

import os

size = os.path.getsize('example.txt')
print(f"文件大小: {size} 字节")
print(f"文件大小: {size / 1024:.2f} KB")
print(f"文件大小: {size / 1024 / 1024:.2f} MB")

输出结果：

文件大小: 2048 字节
文件大小: 2.00 KB
文件大小: 0.00 MB

示例 2：格式化文件大小显示函数

封装一个通用的文件大小格式化函数，自动选择合适的单位进行显示：

import os

def format_size(size_bytes):
    for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
        if size_bytes < 1024:
            return f"{size_bytes:.2f} {unit}"
        size_bytes /= 1024
    return f"{size_bytes:.2f} PB"

files = ['small.txt', 'medium.dat', 'large.bin']
for f in files:
    try:
        size = os.path.getsize(f)
        print(f"{f}: {format_size(size)}")
    except OSError:
        print(f"{f}: 文件不存在")

输出结果：

small.txt: 256.00 B
medium.dat: 1.50 MB
large.bin: 2.30 GB

示例 3：统计目录总大小

由于 os.path.getsize() 只能获取单个文件的大小，要统计目录大小需要遍历所有文件并累加：

import os

def get_dir_size(path):
    total = 0
    for dirpath, dirnames, filenames in os.walk(path):
        for f in filenames:
            filepath = os.path.join(dirpath, f)
            try:
                total += os.path.getsize(filepath)
            except OSError:
                pass
    return total

size = get_dir_size('.')
print(f"当前目录总大小: {size / 1024 / 1024:.2f} MB")

输出结果：

当前目录总大小: 15.67 MB

四、实际应用场景

场景 1：文件上传中检查文件大小限制

在文件上传功能中，服务端需要验证上传文件是否超过允许的最大大小。使用 os.path.getsize() 可以在文件处理前快速检查大小，避免处理过大的文件浪费资源。

场景 2：磁盘清理中找出占用空间最大的文件

在磁盘空间管理工具中，需要扫描目录并找出最大的文件以便清理。通过 os.walk() 遍历文件，配合 os.path.getsize() 获取每个文件的大小，然后按大小排序即可。

场景 3：进度显示中根据文件大小计算处理进度

在文件复制、下载或转换等操作中，已知文件总大小和已处理字节数，可以实时计算并显示处理进度百分比，提升用户体验。

五、注意事项

注意 1：os.path.getsize() 只能获取单个文件的大小。对目录调用它返回的结果不确定（在某些系统上可能返回 4096 等值），不能直接用于获取目录大小。

注意 2：文件不存在或无权限访问时，os.path.getsize() 会抛出 OSError 异常。建议在调用前使用 os.path.exists() 检查或使用 try/except 捕获异常。

注意 3：获取目录大小需要遍历目录中所有文件并累加。对于包含大量文件的目录，这个过程可能比较耗时。

六、常见问题 FAQ

七、练习题