robocopy <源目录> <目标目录> [文件列表] [参数]
说明:Windows Vista/Win7/Win10/Win11、Server 自带,无需安装;源在前、目标在后,不要写反;路径带空格必须用英文双引号包裹 默认:只复制当前目录文件,不自动复制子文件夹
表格
参数 | 作用 |
/S | 复制子目录,不复制空文件夹 |
/E | 复制子目录,包含空文件夹(最常用) |
/MIR | 镜像同步:同步源→目标;目标里源没有的文件会被删除(谨慎!) |
/MT:N | 多线程复制,N=1~128,如 /MT:16 提速 |
/Z | 可重启模式,断点续传(网络拷贝推荐) |
/ZB | 优先断点续传,权限不足时自动切换备份模式 |
/R:N | 失败重试次数,默认 100 万次,一般写 /R:2 |
/W:N | 重试间隔秒数,默认 30 秒,一般写 /W:2 |
/LOG:xxx.log | 输出日志(覆盖旧日志) |
/LOG+:xxx.log | 追加日志,不覆盖 |
/XF | 排除文件,支持通配符 *.tmp |
/XD | 排除目录 |
/NP | 不显示进度百分比(日志干净) |
/MOV | 移动文件(复制后删除源文件) |
/MOVE | 移动文件 + 文件夹 |
robocopy "C:\source" "D:\backup" /E
robocopy "C:\source" "D:\backup" /MIR /MT:16 /R:2 /W:2 /LOG:"D:\backup.log"
robocopy "C:\data" "\\192.168.1.100\share\data" /E /Z /MT:8 /R:2 /W:3
robocopy "C:\source" "D:\docbak" *.docx /E /XF *.tmp
robocopy "C:\project" "D:\project_bak" /E /XD node_modules .git
robocopy "C:\temp" "D:\archive" /E /MOVE /R:1 /W:1
robocopy "C:\source" "D:\backup" /E /MAXAGE:7
robocopy "C:\source" "D:\backup" /E /IORATE:5
robocopy 退出码 0~7 是正常,不是 0 才代表出错:
· 0:无文件复制,两边一致
· 1:成功复制了文件
· ≥8:发生错误(权限、路径不存在等)
如果你需要,我可以给你一个可直接放到任务计划程序里自动备份的 .bat 模板。
免费
今天 14:35
把全部参数都列一下吧
语法:
robocopy <源> <目标> [文件列表] [选项]
属性标记说明:R 只读、A 存档、S 系统、H 隐藏、C 压缩、N 非索引、E 加密、T 临时、O 离线Microsoft ...
表格
参数 | 说明 |
/S | 复制子目录,不复制空文件夹 |
/E | 复制子目录,包含空文件夹 |
/lev:n | 只复制目录树前 n 层 |
/Z | 可重启断点续传模式 |
/B | 备份模式,绕过 ACL 权限限制 |
/ZB | 优先 / Z,权限拒绝自动切 / B |
/J | 无缓冲 IO,大文件推荐 |
/EFSRAW | EFS 加密文件 RAW 模式复制 |
/copy:flags | 复制内容:D 数据 A 属性 T 时间 X 跳过备用流 S ACL O 所有者 U 审计;默认 /copy:DAT |
/dcopy:flags | 目录复制:D A T E X;默认 /dcopy:DA |
/SEC | 复制安全信息 = /copy:DATS |
/COPYALL | 复制全部信息 = /copy:DATSOU |
/NOCOPY | 不复制任何文件信息(配合 purge) |
/SECFIX | 补全安全权限,哪怕文件已跳过 |
/TIMFIX | 补全时间戳,哪怕文件已跳过 |
/PURGE | 删除目标里源不存在的文件 / 目录 |
/MIR | 镜像 = /E + /PURGE(目标多余文件删除) |
/MOV | 移动文件(复制后删源文件) |
/MOVE | 移动文件 + 目录(复制后删源) |
/A+:[RASHCNET] | 给复制后的文件添加属性 |
/A-:[RASHCNETO] | 移除复制后文件的属性 |
/CREATE | 只建目录 + 空文件,不复制数据 |
/FAT | 目标使用 8.3 短文件名 |
/256 | 关闭长路径(>256 字符)支持 |
/mon:n | 监控源,变更≥n 个自动重跑 |
/mot:m | 监控源,检测到变更,m 分钟后重跑 |
/rh:hhmm-hhmm | 允许执行的时间段 |
/pf | 每个文件都校验时间窗口(不是整批) |
/ipg:n | 包间隔,低速链路控带宽 |
/SJ | 把交接点( junction)复制成链接本身,不跳转目标 |
/SL | 复制符号链接本身,不跟随链接 |
/MT:n | 多线程,1~128,默认 8;不能和 /ipg/efsraw 共用 |
/NO DCOPY | 不复制目录信息 |
/NOOFFLOAD | 不使用 Windows 复制卸载机制 |
/COMPRESS | 网络传输时请求压缩(支持的协议) |
/SPARSE:y/n | 是否保留稀疏文件,默认 y |
/NOCLONE | 禁用块克隆加速 |
表格
参数 | 说明 |
/iomaxsize:n[kmg] | 单次读写最大 IO 块大小 |
/iorate:n[kmg] | IO 速率上限(限速,k/m/g) |
/threshold:n[kmg] | 大小阈值,小于该值不参与限速 |
表格
参数 | 说明 |
/A | 只复制存档属性 A 置位的文件 |
/M | 复制存档文件,复制后清除存档位 |
/ia:[RASHCNETO] | 只包含带指定属性的文件 |
/xa:[RASHCNETO] | 排除带指定属性的文件 |
/xf 文件 | 排除文件,支持通配符 |
/xd 目录 | 排除目录 |
/XC | 排除【已更改】文件(大小同、时间不同) |
/XN | 排除源比目标新的文件 |
/XO | 排除源比目标旧的文件 |
/XX | 排除目标独有的文件(不删除,只是不处理) |
/XL | 排除源独有的文件(不新增到目标) |
/IM | 包含修改文件(时间不同,大小相同) |
/IS | 包含完全相同文件(名称 / 大小 / 时间 / 属性全部一致) |
/IT | 包含微调文件(名、大小、时间相同,仅属性不同) |
/max:n | 最大文件,排除大于 n 字节 |
/min:n | 最小文件,排除小于 n 字节 |
/maxage:n | 排除早于 n 天 / 日期(YYYYMMDD)的文件 |
/minage:n | 排除晚于 n 天 / 日期的文件 |
/maxlad:n | 排除超过 n 天未访问的文件 |
/minlad:n | 排除 n 天内访问过的文件 |
/XJ | 排除交接点(junction) |
/XJD | 只排除目录交接点 |
/XJF | 只排除文件交接点 |
/FFT | FAT 时间兼容(2 秒精度) |
/DST | 自动补偿夏令时 DST 一小时时差 |
表格
参数 | 说明 |
/r:n | 失败重试次数,默认 1000000 |
/w:n | 重试间隔秒,默认 30 秒 |
/reg | 把当前 /r/w 保存为注册表默认值 |
/tbd | 等待共享名称解析(错误 67 重试) |
/lfsm | 低磁盘空间模式,空间不足自动暂停;不能和 / MT /EFSRAW 同用 |
/lfsm:n[kmg] | 低空间模式下限值,默认卷容量 10% |
表格
参数 | 说明 |
/L | 仅模拟列出,不复制、不删除(预览,强烈推荐先跑这个) |
/X | 输出所有额外文件(不止选中的) |
/V | 详细模式,列出所有跳过文件 |
/TS | 输出带上源文件时间戳 |
/FP | 输出完整路径 |
/bytes | 大小单位显示字节 |
/NS | 不输出文件大小 |
/NC | 不输出文件分类标记 |
/NFL | 不输出文件名 |
/NDL | 不输出目录名 |
/NP | 不显示进度百分比 |
/ETA | 预估完成时间 |
/log:file | 写入日志,覆盖 |
/log+:file | 追加日志,不覆盖 |
/unilog:file | Unicode 日志覆盖 |
/unilog+:file | Unicode 日志追加 |
/tee | 控制台 + 日志同时输出 |
/NJH | 不输出作业头部 |
/NJS | 不输出作业摘要 |
/unicode | 控制台输出 unicode |
表格
参数 | 说明 |
/job:name | 加载保存好的 job 文件执行 |
/save:name | 把当前所有参数保存为 job 文件 |
/quit | 解析完参数直接退出,用来校验参数 |
/nosd | 不指定源目录 |
/nodd | 不指定目标目录 |
/if | 包含指定文件 |
表格
返回码 | 含义 |
0 | 无文件复制,两边一致,无报错 |
1 | 成功复制文件 |
2 | 目标有源没有的文件,没复制 |
3 | 复制成功,目标存在多余文件 |
5 | 复制成功,存在不匹配文件 |
6 | 目标多余 + 不匹配,无复制 |
7 | 复制成功 + 不匹配 + 目标多余 |
≥8 | 发生错误(权限、路径不存在等) |
习惯写法:脚本里判断 if %errorlevel% GEQ 8 才判定失败
如果你想要,我可以给你一份带注释的 robocopy 备份 bat 模板(包含 / L 预览开关、日志、错误判断)。
免费
今天 14:42
好的
今天 14:42
下面给你一份生产可用、带注释、支持预览、自动判断 robocopy 返回码的批处理模板 RoboBackup.bat。
特性:先 /L 预览(不改动文件),去掉 /L 才正式执行;自动写日志;仅 errorlevel≥8 判定故障;适合任务计划程序。
@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion
:: ===================== 配置区,按需修改 =====================
set "SOURCE=C:\data\myfiles"
set "DEST=D:\backup\myfiles"
set "LOGDIR=D:\backup\log"
set "LOGFILE=%LOGDIR%\robocopy_%date:~0,4%%date:~5,2%%date:~8,2%_%time:~0,2%%time:~3,2%%time:~6,2%.log"
:: 注意:time带空格问题,任务计划里建议用不带时分秒的日志名或者换写法
set "THREAD=16"
set "RETRY=2"
set "WAIT=2"
:: 核心参数
:: /MIR = /E /PURGE 镜像,目标多出文件会删除,谨慎!
set "ROBO_OPTS=/MIR /MT:%THREAD% /R:%RETRY% /W:%WAIT% /V /TS /FP /NP /TEE"
:: 预览模式:加上 /L 只列出、不复制不删除;正式跑删掉 /L
set "PREVIEW=/L"
:: ==========================================================
:: 自动创建日志目录
if not exist "%LOGDIR%" md "%LOGDIR%"
echo ==============================================
echo 源目录:%SOURCE%
echo 目标目录:%DEST%
echo 日志:%LOGFILE%
echo 预览标记:%PREVIEW%
echo ==============================================
echo.
robocopy "%SOURCE%" "%DEST%" %ROBO_OPTS% %PREVIEW% /LOG:"%LOGFILE%"
:: robocopy 退出码规则:0~7 属于正常,>=8 才是错误
set RC=%errorlevel%
echo.
echo Robocopy 返回码:%RC%
if %RC% GEQ 8 (
echo 【失败】检测到严重错误!
endlocal
exit /b %RC%
) else (
echo 【正常完成】返回码 %RC% 属于robocopy正常状态(0~7)
endlocal
exit /b 0
)
1. 把 SOURCE、DEST、LOGDIR 改成你自己路径;
2. 第一次运行务必保留 set "PREVIEW=/L",看日志确认要删 / 要同步的文件是否符合预期;
3. 确认无误后,改成 set "PREVIEW=" 去掉预览,开始真实同步;
4. 如果不需要镜像(不想删除目标多余文件):把 /MIR 换成 /E。
· 只增量同步、不删目标文件:
set "ROBO_OPTS=/E /MT:%THREAD% /R:%RETRY% /W:%WAIT% /V /TS /FP /NP /TEE"
· 网络 NAS 共享、断点续传:增加 /Z
set "ROBO_OPTS=/MIR /Z /MT:%THREAD% /R:%RETRY% /W:%WAIT% /V /TS /FP /NP /TEE"
· 排除目录(例如 node_modules、.git),在参数末尾追加:
/XD node_modules .git "$RECYCLE.BIN" System Volume Information
示例:
set "ROBO_OPTS=/MIR /MT:%THREAD% /R:%RETRY% /W:%WAIT% /V /TS /FP /NP /TEE /XD node_modules .git"
1. 触发器:每天凌晨;
2. 操作:启动程序,程序填 cmd.exe,参数:
/c ""D:\scripts\RoboBackup.bat""
1. 勾选「不管用户是否登录都运行」;
2. 如果访问网络共享,任务计划账号要有共享权限;
3. 日志会按日期时间生成,方便回溯。