shutil是Python中用于高级文件操作的模块，提供复制（copy、copy2、copyfile）、移动（move）、删除目录（rmtree）、复制目录树（copytree）、获取磁盘使用情况（disk_usage）、修改所有者（chown）及归档压缩（make_archive、unpack_archive）等功能，适用于备份、部署等用户级文件管理任务。

shutil 是 Python 中用于文件和目录的高级操作模块，相比 os 模块更侧重于复制、移动、删除等实际文件操作。以下是 shutil 提供的主要文件操作方法及其用途。

1. 复制文件

用于将文件从一个位置复制到另一个位置，支持保留元数据或设置权限。

• shutil.copy(src, dst)：复制文件内容和权限，不保留元数据（如创建/修改时间）。
• shutil.copy2(src, dst)：复制文件内容、权限以及所有元数据（推荐用于完整复制）。
• shutil.copyfile(src, dst)：仅复制文件内容，目标必须是文件路径（不能是目录）。

2. 移动和重命名文件

用于移动文件或目录，也可用于重命名。

• shutil.move(src, dst)：将文件或目录从 src 移动到 dst。如果 dst 是目录，则放入该目录；如果是文件路径，则可能重命名。

3. 删除目录（递归）

用于删除整个目录树（包括子目录和文件）。

立即学习“Python免费学习笔记（深入）”；

A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.

调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。

下载

• shutil.rmtree(path)：删除指定路径的目录及其所有内容。注意：无法删除非空目录的单个文件，只适用于目录。

4. 复制目录结构

用于复制整个目录树。

• shutil.copytree(src, dst)：递归复制整个目录及其子目录和文件。dst 目录不能已存在。
• 可通过参数 ignore 忽略某些文件，如临时文件或缓存。

5. 获取磁盘空间信息

虽然不是直接操作文件，但常用于判断是否可执行写入操作。

• shutil.disk_usage(path)：返回总空间、已用空间和可用空间（以字节为单位）。

6. 文件元信息操作

获取或设置文件元数据。

• shutil.chown(path, user=None, group=None)：更改文件或目录的所有者和组（Unix 系统有效）。

7. 归档与压缩

打包目录为压缩文件，支持多种格式。

• shutil.make_archive(base_name, format, root_dir)：创建归档文件（如 zip、tar）。
• shutil.unpack_archive(filename, extract_dir)：解压归档文件到指定目录。 基本上就这些常用操作。shutil 适合处理“用户级”文件任务，比如备份、清理、部署等，比底层 os 或 pathlib 更方便。