在自动化脚本、批处理、测试框架中，你肯定遇到过：

• 批量复制文件夹？
• 快速打包一个目录？
• 清空临时文件？
• 自动归档运行日志？

Python 内置库 shutil，专为文件/目录操作而生，让你不用再手写复杂的 os.path 逻辑！

迟做总比不做好。

加油每一位！

常用功能速查（建议收藏）

实战案例演示

1 复制单个文件

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish 
@File    ：main.py
@Date    ：2025/7/6 20:48
@Author : malijie
"""
import shutil

shutil.copy("data.txt", "backup/data_copy.txt")

说明：目标路径可以改名，若目录不存在会报错。

2 复制整个目录

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish 
@File    ：main.py
@Date    ：2025/7/6 20:48
@Author : malijie
"""
import shutil

shutil.copytree("logs", "logs_backup")

会递归复制所有内容。若目标已存在，需先删除或加参数：

shutil.copytree("logs", "logs_backup", dirs_exist_ok=True)

3 移动或重命名文件/文件夹

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish 
@File    ：main.py
@Date    ：2025/7/6 20:48
@Author : malijie
"""
import shutil

shutil.move("Apple Music.csv", "logs_backup/2025_Apple_Music.csv")

类似 Linux 的 mv，同目录则是重命名，跨目录则是移动。

4 删除整个目录

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish 
@File    ：main.py
@Date    ：2025/7/6 20:48
@Author : malijie
"""
import shutil

shutil.rmtree("temp_folder")

不仅删除空目录，还能清除所有子文件夹和文件。

5 打包目录成 zip 文件

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish 
@File    ：main.py
@Date    ：2025/7/6 20:48
@Author : malijie
"""
import shutil

shutil.make_archive("Jay Chou", "zip", "十一月的肖邦")

输出为 archive_2025.zip，内容为 logs 文件夹。

支持格式包括：zip、tar、gztar、bztar、xztar

6 解压文件

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish 
@File    ：main.py
@Date    ：2025/7/6 20:48
@Author : malijie
"""
import shutil

shutil.unpack_archive("Jay Chou.zip", extract_dir="周杰伦")

快速解压到指定目录，不需要引入额外的 zip 模块！

7 查询磁盘空间

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish 
@File    ：main.py
@Date    ：2025/7/6 20:48
@Author : malijie
"""
import shutil

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

常用于部署脚本、备份脚本中的空间检查。

实际应用场景

自动化测试：保存截图、移动日志、清理缓存

数据处理脚本：定期打包归档、按日期命名移动

文件同步工具：跨平台迁移文件

本地备份工具：只需 shutil 就能搞定压缩、解压、备份

常见注意事项

• copytree() 目标路径不能存在，除非 dirs_exist_ok=True
• rmtree() 删除操作需谨慎，无法撤销
  
• make_archive() 输出文件不要加扩展名，系统会自动添加

写在最后

shutil 是 Python 中最实用也最容易忽视的库之一，用好它能让你少写一堆繁琐代码。

下期预告：《subprocess 命令执行实战，自动调用 shell 脚本原来这么简单》

如果你喜欢这种风格，欢迎点赞 + 收藏 + 评论支持我继续更新。