先给结论
复制整个文件夹,别用 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 怎么配合,把"删不干净"拆开处理——这棵目录树在删除篇还会继续当对照。