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。