shutil.copytree默认要求目标目录不存在，否则抛FileExistsError；Python 3.8+可用dirs_exist_ok=True跳过该错误，仅覆盖同名文件，不清理目标中多余内容。
copytree 会直接报错说目标目录已存在
这是最常遇到的问题：
默认不允许目标路径存在，哪怕是个空文件夹也会抛出
。它设计上就要求目标目录必须不存在——不是“跳过”，而是“严格新建”。
解决方法只有两个：要么手动删掉目标目录，要么自己实现覆盖逻辑。Python 3.8+ 提供了
参数，但要注意它只跳过“目录已存在”错误，不处理同名文件冲突：
这个参数在旧版本（TypeError。
想覆盖已有文件就得自己遍历 + copy2
本身不支持“强制覆盖文件”，即使开了
，遇到同名文件仍会失败（比如
已存在，而
也要拷过去）。这时候得退回到底层组合操作：
立即学习
“
Python免费学习笔记（深入）
”；
用
遍历源目录树
对每个文件，用
算出相对路径，拼到目标根目录下
确保目标父目录存在（
）
调用
（保留时间戳和权限）或
（仅内容）
注意别用
——它不支持目录创建，且不保留元数据。
忽略某些文件或目录要用 ignore 参数
的
参数接收一个函数，签名是
。常见误用是直接返回布尔值或字符串，结果报错或无效。
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
正确写法示例（忽略
和所有
文件）：
注意：这个函数对每个子目录都会被调用一次，
是当前目录下的全部条目名（不含路径），不是全路径。
符号链接默认被展开，要保留得加 symlinks=True
默认情况下，
遇到符号链接会把链接指向的真实文件/目录复制过去（即“解引用”）。如果源里有
，默认行为会把
的内容整个复制进
，而不是建个新链接。
要原样复制符号链接本身，必须显式传
：
这个选项和
可以共存，但要注意：如果目标系统不支持符号链接（如某些 FAT32 挂载点），会抛出
。
真正麻烦的是混合需求：既要覆盖文件、又要保留链接、还要忽略部分路径、还得兼容老 Python 版本——这种时候别硬塞进
，老老实实写个带条件分支的遍历循环更可控。
shutil.copytreeFileExistsErrordirs_exist_okshutil.copytree("src", "dst", dirs_exist_ok=True)copytreedirs_exist_ok=Truedst/a.txtsrc/a.txtos.walkos.path.relpathos.makedirs(..., exist_ok=True)shutil.copy2shutil.copyshutil.copyfilecopytreeignoreignore(src_dir, names) → list_of_names_to_ignore.git.pycdef ignore_func(dir, contents):
return [n for n in contents if n == ".git" or n.endswith(".pyc")]
shutil.copytree("src", "dst", ignore=ignore_func)contentscopytreeln -s ../data data_link../datadst/data_linksymlinks=Trueshutil.copytree("src", "dst", symlinks=True)dirs_exist_okOSErrorcopytree