先给结论

复制整个文件夹,别用 copy,用 robocopy:

robocopy "源目录" "目标目录" /E
  • copy 只搬文件,不进子目录。
  • xcopy 要凑齐 /E /H /I,少一个就漏文件或卡住。
  • robocopy /E 一条到位,隐藏项、空目录默认全带上。
  • 唯一危险的是 /MIR——它会删目标里多出来的东西,动手前先加 /L 看一遍。

演示用的目录结构

全文都拿这棵树举例,故意埋了隐藏文件、空目录、嵌套子目录,正好看清三条命令各漏在哪。

E:\cmd-demo\copy
└── src 目录                  ← 名字带空格和中文
    ├── plain.txt
    ├── hidden.txt            (隐藏文件)
    ├── empty                 (空目录)
    ├── hide                  (隐藏目录)
    │   └── inside.txt
    └── sub
        ├── sub.txt
        ├── deep
        │   └── deep.txt
        └── empty2            (空目录)

一、copy:只认文件,不认目录树

copy "E:\cmd-demo\copy\src 目录" "E:\cmd-demo\copy\copy-root"

回显 已复制 1 个文件,看着成功,其实只过去了 plain.txt——sub、empty、hide、hidden.txt 一个没跟过来。

原因:copy 的源写成目录时,只处理这一层的文件,不递归、不建空目录、不碰隐藏项。那句 已复制 1 个文件 指的是根层唯一的可见文件,不是"目录复制完成"。

截图

四个坑:

写法 结果
目标是带 \ 的目录、但目录不存在 报 系统找不到指定的路径,一个不复制
目录作源、目标不存在、末尾无 \ 不报错,把根层所有文件内容串成一个同名文件——最阴,看着成功实则全毁
源文件是隐藏的 报 系统找不到指定的文件,copy 默认不碰隐藏项
多文件拼接 a+b 加号必须写在引号外,写成 "a.txt+b.txt" 会被当成一个文件名

结论:copy 只适合把单个文件复制进已存在的目录,没有递归参数,也没有隐藏项开关。拿它复制文件夹,最常见的结局就是"看着成功、实际残缺"。


二、xcopy:/E 补子目录,/H 补隐藏项,/I 补目标不存在

xcopy "E:\cmd-demo\copy\src 目录" "E:\cmd-demo\copy\目标" /E /H /I /Y

三个参数各管一件事,缺一不可:

参数 补什么 少了会怎样
/E 递归子目录 + 建空目录 只复制根层,sub、deep 都不建
/H 隐藏文件和隐藏目录 漏掉 hidden.txt、hide\inside.txt(/E 不管隐藏项)
/I 目标不存在时按目录处理 卡在 目标 xxx 是文件名还是目录名(F = 文件,D = 目录)? 干等
/Y 覆盖已有文件不询问 逐个确认

常见误解:/E 不建空目录——错的,空目录它建。它真正漏的是隐藏项,得靠 /H 补。

截图

截图

结论:xcopy 能递归也能带隐藏项,但 /E /H /I 必须凑齐,啰嗦。


三、robocopy:一个 /E 就够,危险的是 /MIR

robocopy "E:\cmd-demo\copy\src 目录" "E:\cmd-demo\copy\目标" /E

5 个文件全部到位,隐藏项、空目录、隐藏属性一个不落。

为什么比 xcopy 省参数:robocopy 的 /E 默认就含隐藏文件和隐藏目录,不用再加 /H。这是它和 xcopy 最关键的差别,也是"复制目录树首选它"的核心理由。

/E 和 /MIR 的区别:

  • /E 只复制、覆盖,不动目标里多出来的东西。
  • /MIR(镜像)= /E + 删除目标里源没有的文件和目录。多余项会直接消失,日志里记为 *EXTRA File、*EXTRA Dir。

⚠️ 想让目标"和源完全一致"时 /MIR 是利器,只想"把源搬过去"时它是炸弹。动手前先预演:

robocopy "源" "目标" /MIR /L

/L 只列出将要做什么,不复制、不删除、不建目录。确认 EXTRA 列表都是要删的,再去掉 /L 真跑。

截图

结论:robocopy /E 是三条里最省事的递归复制,还附带多线程、长路径、日志、明确退出码。要警惕的只有 /MIR 的删除行为。


四、退出码怎么看(写 bat 必看)

robocopy 的退出码是位掩码,不是"0 成功、非 0 失败":

退出码 含义 算错误吗
0 无变化,源和目标本就一致 否
1 有文件被成功复制 否
2 目标有源不存在的多余项 否
4 有文件不匹配(大小/时间戳) 否
8 有文件复制失败(权限、占用、路径过长) 是
16 严重错误,命令没跑起来 是

1、2、4 都是"活干成了",只有 ≥ 8 才是真失败。 所以 bat 里千万别写 if errorlevel 1 (echo 失败)——一复制到文件就误报:

robocopy "源" "目标" /E
if %ERRORLEVEL% GEQ 8 (
    echo 复制失败,退出码 %ERRORLEVEL%
)

截图


五、参数速查表

命令 参数 作用
copy /Y 覆盖不询问(本身不递归、不碰隐藏项)
xcopy /E 递归 + 建空目录
xcopy /S 递归但跳过空目录(和 /E 只差这点)
xcopy /H 带隐藏文件和目录
xcopy /I 目标不存在按目录处理,不询问
robocopy /E 递归 + 空目录 + 默认含隐藏项
robocopy /MIR 镜像 = /E + 删除多余项
robocopy /L 只预览,不动任何文件
robocopy /MT[:n] 多线程,默认 8,适合海量小文件
robocopy /R:n /W:n 重试 n 次、间隔 n 秒(默认重试百万次,脚本里设小)
robocopy /LOG:文件 写日志

六、该用哪个

场景 选择
几个单独文件复制进已存在目录 copy
复制整个目录树、保留空目录 robocopy /E
源里有隐藏文件/目录 robocopy /E(无需额外参数)
目标目录还不存在 robocopy /E
要目标和源完全一致 robocopy /MIR(先 /L)
目录大、路径长、要日志和可判断结果 robocopy
只想看会复制哪些 robocopy /L
老系统没有 robocopy xcopy /E /H /I /Y

一句话:新脚本一律 robocopy,copy 留给单文件,xcopy 只在老机器上兜底。


七、报错速查表

现象 原因 处理
已复制 1 个文件 但子目录没过去 用了 copy,它不递归 换 robocopy /E
系统找不到指定的路径(copy) 目标是带 \ 的目录但不存在 先建目录,或换 robocopy
目录复制完变成一个同名文件 copy 把内容串进了文件 别用 copy 复制目录
系统找不到指定的文件 源是隐藏文件 加 /H,或换 robocopy
目标 xxx 是文件名还是目录名(F = 文件,D = 目录) xcopy 目标不存在又没 /I 补 /I,或换 robocopy
脚本跑到 xcopy 就停、目标没建 无人值守卡在询问,退出码 2 补 /I,或换 robocopy
跑完 /MIR 目标文件没了 镜像删掉了源里没有的项 下次先 /L 看 EXTRA

可以直接抄的一段

:: 日常复制整个目录树
robocopy "D:\项目" "E:\备份\项目" /E

:: 海量小文件:多线程 + 日志
robocopy "D:\照片" "E:\备份\照片" /E /MT:16 /LOG:"E:\备份\照片.log"

:: 让备份和源完全一致:先预演,再正式跑
robocopy "D:\项目" "E:\备份\项目" /MIR /L
robocopy "D:\项目" "E:\备份\项目" /MIR

:: bat 里判断成败:≥8 才是真失败
robocopy "D:\项目" "E:\备份\项目" /E /R:2 /W:1
if %ERRORLEVEL% GEQ 8 (
    echo 复制失败,退出码 %ERRORLEVEL%
)

下一篇

复制解决了,下一步是删不掉:文件被占用、rd 删到一半停住、有权限却提示拒绝访问。下一篇讲 del、rmdir /s /q、taskkill、forfiles 怎么配合,把"删不干净"拆开处理——这棵目录树在删除篇还会继续当对照。