Robocopy 语法

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

移动文件 + 文件夹


示例

1. 基础复制:复制全部子目录(含空文件夹)

robocopy "C:\source" "D:\backup" /E

2. 镜像同步(备份常用,目标多余文件会删除!)

robocopy "C:\source" "D:\backup" /MIR /MT:16 /R:2 /W:2 /LOG:"D:\backup.log"

3. 网络共享拷贝、断点续传(NAS / 服务器)

robocopy "C:\data" "\\192.168.1.100\share\data" /E /Z /MT:8 /R:2 /W:3

4. 只复制 *.docx 文件,排除 tmp 缓存文件

robocopy "C:\source" "D:\docbak" *.docx /E /XF *.tmp

5. 排除 node_modules 文件夹(开发目录同步)

robocopy "C:\project" "D:\project_bak" /E /XD node_modules .git

6. 移动文件(复制完删掉源)

robocopy "C:\temp" "D:\archive" /E /MOVE /R:1 /W:1

7. 只复制 7 天内修改过的文件(增量筛选)

robocopy "C:\source" "D:\backup" /E /MAXAGE:7

8. 限速复制(IORate,单位 m=MB/s)

robocopy "C:\source" "D:\backup" /E /IORATE:5


退出码小提示

robocopy 退出码 0~7 是正常,不是 0 才代表出错:

· 0:无文件复制,两边一致

· 1:成功复制了文件

· ≥8:发生错误(权限、路径不存在等)

如果你需要,我可以给你一个可直接放到任务计划程序里自动备份的 .bat 模板。

免费

今天 14:35

把全部参数都列一下吧

robocopy 完整参数表(微软官方原版,按分类)

语法:

robocopy <源> <目标> [文件列表] [选项]

属性标记说明:R 只读、A 存档、S 系统、H 隐藏、C 压缩、N 非索引、E 加密、T 临时、O 离线Microsoft ...

一、复制选项(Copy options)

表格

参数

说明

/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

禁用块克隆加速

二、IO 限速选项

表格

参数

说明

/iomaxsize:n[kmg]

单次读写最大 IO 块大小

/iorate:n[kmg]

IO 速率上限(限速,k/m/g)

/threshold:n[kmg]

大小阈值,小于该值不参与限速

三、文件筛选选项(File selection)

表格

参数

说明

/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 一小时时差

四、重试选项(Retry)

表格

参数

说明

/r:n

失败重试次数,默认 1000000

/w:n

重试间隔秒,默认 30 秒

/reg

把当前 /r/w 保存为注册表默认值

/tbd

等待共享名称解析(错误 67 重试)

/lfsm

低磁盘空间模式,空间不足自动暂停;不能和 / MT /EFSRAW 同用

/lfsm:n[kmg]

低空间模式下限值,默认卷容量 10%

五、日志输出选项(Logging)

表格

参数

说明

/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)

表格

参数

说明

/job:name

加载保存好的 job 文件执行

/save:name

把当前所有参数保存为 job 文件

/quit

解析完参数直接退出,用来校验参数

/nosd

不指定源目录

/nodd

不指定目标目录

/if

包含指定文件


退出码汇总(重点!robocopy 非 0 也可能成功)

表格

返回码

含义

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. 日志会按日期时间生成,方便回溯。

进阶需求可选加