Python 标准库模块shutil

shutil（Shell Utilities）是 Python 标准库中用于高级文件操作的模块，提供了比 os模块更便捷的文件/目录复制、移动、删除、归档等功能。下面详细介绍其核心功能、参数说明及示例代码。

​1. 文件复制​

​​(1) shutil.copy(src, dst)​

​作用​：复制文件到目标路径（保留文件权限，但不保留元数据如修改时间）。

​参数​：

• src：源文件路径（必须是文件，不能是目录）。
• dst：目标路径（可以是文件名或目录）。

​示例​：

import shutil# 复制文件到目标目录（保留文件名）
shutil.copy("source.txt", "backup/")  # 目标路径是目录，自动保留原文件名# 复制文件并重命名
shutil.copy("source.txt", "backup/copied_file.txt")  # 指定新文件名

​​(2) shutil.copy2(src, dst)​

​作用​：复制文件并保留所有元数据（如修改时间、创建时间等）。

​参数​：同 shutil.copy()。

​示例​：

shutil.copy2("source.txt", "backup/")  # 保留元数据

​​(3) shutil.copyfile(src, dst)​

​作用​：仅复制文件内容（不复制权限、元数据）。

​参数​：

• src：源文件路径。
• dst：目标文件路径（必须是文件名，不能是目录）。

​示例​：

shutil.copyfile("source.txt", "backup/copied_content.txt")  # 仅复制内容

​2. 目录操作​

​​(1) shutil.copytree(src, dst)​

​作用​：递归复制整个目录树（包括子目录和文件）。

​参数​：

• src：源目录路径。
• dst：目标目录路径（必须不存在，否则报错 FileExistsError）。

​示例​：

# 复制整个目录
shutil.copytree("my_folder", "backup_folder")  # 目标目录必须不存在

​​(2) shutil.rmtree(path)​

​作用​：递归删除目录及其所有内容（类似 rm -rf）。

​参数​：

• path：要删除的目录路径。

​示例​：

shutil.rmtree("temp_folder")  # 慎用！不可恢复

​3. 文件移动​

​shutil.move(src, dst)​

​作用​：移动文件或目录（类似剪切操作）。

​参数​：

• src：源路径（文件或目录）。
• dst：目标路径（可以是目录或新文件名）。

​示例​：

# 移动文件
shutil.move("old_location/file.txt", "new_location/")  # 移动到目录
shutil.move("file.txt", "renamed_file.txt")  # 移动并重命名# 移动目录
shutil.move("old_dir", "new_dir")  # 目录移动

​4. 归档与压缩​

​​(1) shutil.make_archive(base_name, format, root_dir)​

​作用​：创建压缩包（支持 zip、tar、gztar等格式）。

​参数​：

• base_name：压缩包名称（不带扩展名）。
• format：压缩格式（"zip"、"tar"、"gztar"等）。
• root_dir：要压缩的目录路径。

​示例​：

# 创建 ZIP 压缩包
shutil.make_archive("backup", "zip", "my_folder")  # 生成 backup.zip# 创建 TAR.GZ 压缩包
shutil.make_archive("backup", "gztar", "my_folder")  # 生成 backup.tar.gz

​​(2) shutil.unpack_archive(filename, extract_dir)​

​作用​：解压归档文件（支持 zip、tar、gztar等）。

​参数​：

• filename：压缩包路径。
• extract_dir：解压目标目录（可选，默认当前目录）。

​示例​：

# 解压 ZIP 文件
shutil.unpack_archive("backup.zip", "extracted_files/")

​5. 磁盘空间查询​

​shutil.disk_usage(path)​

​作用​：返回磁盘使用情况（总空间、已用空间、剩余空间）。

​参数​：

• path：要查询的路径（如 "/"或 "C:"）。

​返回值​：namedtuple包含 total、used、free（单位：字节）。

​示例​：

usage = shutil.disk_usage("/")
print(f"总空间: {usage.total / (1024**3):.2f} GB")
print(f"已用空间: {usage.used / (1024**3):.2f} GB")
print(f"剩余空间: {usage.free / (1024**3):.2f} GB")

​总结​

shutil适合处理高级文件操作，而底层控制（如文件句柄）仍需结合 os或 pathlib。