Python 的标准库shutil: 优雅的文件和目录操作

liuian 2025-06-30 17:56 18 浏览

shutil 是 Python 的标准库之一，提供了许多文件和目录操作的功能。以下是 shutil 常用的功能列表，并给出了每个功能的简单示例：

文件和目录的复制

(shutil.copy, shutil.copy2, shutil.copyfile, shutil.copytree):

import shutil

# 复制文件
shutil.copy('source.txt', 'destination.txt')

# 复制文件，保留元数据（如访问时间、修改时间等）
shutil.copy2('source.txt', 'destination.txt')

# 复制文件内容（不包括元数据）
shutil.copyfile('source.txt', 'destination.txt')

# 复制目录及其内容
shutil.copytree('source_dir', 'destination_dir')

文件和目录的移动和重命名 (shutil.move, shutil.rename):

import shutil

# 移动文件或目录
shutil.move('source.txt', 'destination.txt')

# 重命名文件或目录
shutil.rename('old_name.txt', 'new_name.txt')

文件和目录的删除 (shutil.rmtree, os.remove):

import shutil

# 递归删除目录及其内容
shutil.rmtree('directory')

# 删除文件
os.remove('file.txt')

压缩和解压缩文件 (shutil.make_archive, shutil.unpack_archive):

import shutil

# 创建压缩文件（支持多种格式，如 zip、tar、gztar）
shutil.make_archive('archive', 'zip', 'directory')

# 解压缩压缩文件
shutil.unpack_archive('archive.zip', 'extracted_directory')

文件和目录的权限设置 (shutil.chown, shutil.chmod):

import shutil

# 修改文件或目录的所有者和组
shutil.chown('file.txt', user='new_user', group='new_group')

# 修改文件或目录的权限
shutil.chmod('file.txt', mode=0o755)

获取文件大小、获取最后访问时间等 (shutil.disk_usage, shutil.getatime, shutil.getmtime, shutil.getctime):

import shutil

# 获取磁盘使用情况
usage = shutil.disk_usage('/path/to/directory')
print(usage.total, usage.used, usage.free)

# 获取文件或目录的最后访问时间、修改时间、创建时间
atime = shutil.getatime('file.txt')
mtime = shutil.getmtime('file.txt')
ctime = shutil.getctime('file.txt')

目录的遍历 (shutil.walk):

import shutil

# 遍历目录及其子目录中的所有文件和文件夹
for root, dirs, files in shutil.walk('directory'):
    print(root)  # 当前遍历的目录
    print(dirs)  # 当前目录下的子目录
    print(files)  # 当前目录下的文件

文件和目录的比较 (shutil.cmp):

import shutil

# 比较两个文件的内容是否相同
same = shutil.cmp('file1.txt', 'file2.txt')

# 比较两个目录的内容是否相同
same = shutil.cmp('dir1', 'dir2')

创建临时文件和目录 (shutil.mkstemp, shutil.mkdtemp):

import shutil

# 创建临时文件（返回文件对象和文件路径）
temp_file = shutil.mkstemp(suffix='.txt', prefix='temp_', dir='temp_dir')

# 创建临时目录（返回目录路径）
temp_dir = shutil.mkdtemp(prefix='temp_')

获取文件或目录的状态信息 (shutil.stat):

import shutil

# 获取文件或目录的状态信息
stat_info = shutil.stat('file.txt')

# 获取文件或目录的大小（字节数）
file_size = stat_info.st_size

# 获取文件或目录的权限（八进制数表示）
file_mode = stat_info.st_mode

# 获取文件或目录的最后访问时间
access_time = stat_info.st_atime

shutil.move