使用shutil.copytree复制目录触发[WinError 183]错误求助

这种矛盾的报错我之前帮朋友排查过好几次，看似所有文件都复制完了，但系统硬说文件存在，其实根源多半在文件系统的隐形状态或者复制操作的细节逻辑上，给你几个实用的排查方向：

1. 先排查后台进程的文件锁定 #

Windows下很多后台程序会悄悄锁定文件——比如实时杀毒软件扫描、资源管理器的预览功能、甚至是某些同步工具（比如OneDrive）。这些锁定会让系统误以为文件还在创建过程中，或者已经存在，哪怕你肉眼看不到。

• 解决步骤：
  • 关闭所有打开的资源管理器窗口，尤其是指向源目录或目标目录的；
  • 暂时禁用杀毒软件的实时防护（复制完再打开）；
  • 打开任务管理器，找到Windows资源管理器进程，右键重启它，然后再检查目标目录。

2. 检查复制工具的递归创建逻辑 #

如果你是用代码（比如Python的shutil.copytree）或者第三方工具复制，很可能是工具的逻辑导致的：比如copytree默认会尝试创建目标目录本身，如果目标目录已经提前存在（哪怕是空的），就会抛出WinError 183——哪怕你觉得是“新建目录”，也可能不小心提前创建了。

• 解决方法：
  • 代码层面：如果用Python 3.8+，给copytree加上dirs_exist_ok=True参数，允许目标目录存在时继续复制；
  • 手动复制：先彻底删除目标目录（确认回收站也清空），再重新执行复制操作，不要提前创建目标文件夹。

3. 用更稳定的命令行工具替代图形化复制 #

系统自带的复制粘贴有时候对隐藏/系统文件处理不够灵活，比如Thumbs.db、桌面.ini这类文件，可能复制时被跳过或者锁定，导致后续报错。推荐用robocopy命令，它是Windows专门的批量复制工具，处理这类问题更靠谱：

robocopy "你的源目录路径" "你的目标目录路径" /E /COPYALL /R:3 /W:5

参数说明：

• /E：递归复制所有子目录（包括空目录）；
• /COPYALL：复制所有文件属性（包括隐藏、系统属性）；
• /R:3：失败时重试3次；
• /W:5：重试间隔5秒。

4. 检查磁盘的文件系统错误 #

如果磁盘存在轻微的文件系统损坏，也可能导致系统误判文件状态。

• 解决步骤：
  • 右键目标磁盘（比如D盘）→ 属性 → 工具 → 检查；
  • 按照提示扫描并修复文件系统错误，完成后再尝试复制。

一般来说，先试前两个方法就能解决问题，如果不行再用robocopy或者磁盘检查，大概率能搞定。

内容的提问来源于stack exchange，提问作者Gabe Weiner