如何利用Python shutil模块实现文件夹的递归复制与移动？-Python教程-PHP中文网

应传入dirs_exist_ok=true（python 3.8+）并配合copy_function=shutil.copy2及ignore参数处理只读文件与过滤目录；旧版本需先shutil.rmtree(dst)再copytree。

如何利用python shutil模块实现文件夹的递归复制与移动？

shutil.copytree() 复制整个文件夹时 PermissionError 怎么办？

直接调用 shutil.copytree() 会失败，如果目标路径已存在，它会直接抛出 FileExistsError；如果源目录里有只读文件（比如 .git/ 中的文件），又可能触发 PermissionError。这不是 bug，是设计使然——它默认不做覆盖、不绕过权限检查。

解决办法是传入 dirs_exist_ok=True（Python 3.8+）并配合自定义 ignore 或 copy_function：

import shutil
import os
<p>def copy_with_permissions(src, dst):
shutil.copytree(
src, dst,
dirs_exist_ok=True,
ignore=shutil.ignore_patterns('<strong>pycache</strong>', '.git'),
copy_function=shutil.copy2  # 保留 mtime/atime
)</p><h1>若需兼容旧版 Python（</h1><p>if os.path.exists(dst):
shutil.rmtree(dst)
shutil.copytree(src, dst)</p>

shutil.move() 移动文件夹跨磁盘时实际是“复制 + 删除”，怎么确认是否成功？

shutil.move() 在同一文件系统内是原子重命名（快且安全），但跨分区（比如从 /home 到 /mnt/usb）会退化为 shutil.copytree() + shutil.rmtree()。这意味着：中途失败会导致源还在、目标不完整，极易误判“移动成功”。

必须检查返回值和异常，并验证目标完整性：

捕获 OSError 和 shutil.Error，它们都可能在复制阶段抛出
移动后用 os.path.exists(dst) + shutil.disk_usage(dst) 粗略校验大小
关键场景建议改用 shutil.copytree() + 手动 shutil.rmtree(src)，把两步拆开，失败时可回滚

如何跳过特定子目录（如 pycache、.venv）而不写死 ignore 列表？

shutil.copytree() 的 ignore 参数接受函数，比 ignore_patterns() 更灵活。例如动态排除所有以 . 或 __ 开头的目录：

huaweicloud-python-sdk-helper

华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。

下载

def ignore_hidden_or_cache(path, names):
    ignored = []
    for name in names:
        full_path = os.path.join(path, name)
        if name.startswith('.') or name.startswith('__') or name == 'venv':
            ignored.append(name)
        elif os.path.isdir(full_path) and name.lower() in ['env', 'node_modules']:
            ignored.append(name)
    return ignored
<p>shutil.copytree(src, dst, ignore=ignore_hidden_or_cache)</p>

注意：这个函数接收的是父路径 path 和当前层的 names 列表，不是单个文件名；返回要忽略的名称列表，不是布尔值。