Linux rsync --delete 使用前如何预览删除文件

rsync 的 `--delete` 不是用来一键清空目标文件夹的快捷指令，它只会在当前正在同步的目标目录中，删除源端不存在的多余文件。正式执行同步操作之前，你可以先完全沿用原本准备用的源路径、目标路径、过滤参数和 `--delete` 配置，只额外增加 `--dry-run`（或 `-n`）与 `--itemize-changes`（或 `-i`）参数，先把完整的待删除文件清单过一遍，确认没问题之后再决定是否执行真实的删除操作。

rsync 带删除的高危操作前，保持其余参数不变，追加 -ni 参数跑模拟同步，输出结果里标记 *deleting 的行就是本次操作会删掉的文件/文件夹清单。

官方文档：https://download.samba.org/pub/rsync/rsync.1

最稳妥的做法是先运行 rsync -aivn --delete 源目录/ 目标目录/，确认所有 *deleting 路径都应该消失，再把同一条命令中的 -n 去掉；不要同时修改目录斜杠、exclude 规则或目标路径。

先把 rsync 的同步范围画对

先确认两件事：源目录和目标目录分别是谁，以及你想同步的是“目录本身”还是“目录内容”。例如下面的命令把 /srv/release/ 的内容映射到远端 /srv/app/：

rsync -aivn --delete /srv/release/ backup@backup01:/srv/app/
# -n 只预览；-i 展示每个路径的变化；--delete 检查目标端多余文件

这里的源路径有末尾斜杠，表示把 release 目录里的内容放进 app；如果写成 /srv/release，目标端可能多出一层 release 目录。另一个常见坑是写成 /srv/release/*：星号先由 shell 展开，rsync 收到的是一组文件，而不是完整目录，--delete 的比较范围也随之改变。

用 dry-run 读懂删除清单

-n 是 --dry-run 的短写，它执行一次试运行，不修改源端或目标端。-v 让路径更容易被看到，-i 则给出变更类型。删除项通常会以 *deleting path/to/file 的形式出现；新增、内容更新和属性变化则是另一类记录，不能把所有输出都当成删除。

预览时重点看三层：第一，*deleting 后的路径是否都属于本次镜像范围；第二，exclude/include 是否把日志、缓存或人工保留目录保护住；第三，新增与更新数量是否符合这次发布预期。默认情况下，被排除的文件也不会参与删除，除非额外使用了风险更高的 --delete-excluded。

给正式执行加一道数量护栏

如果平时一次只会删除几十个文件，可以在正式命令中加入 --max-delete=50。超过上限时，rsync 会跳过后续删除并返回退出码 25；这不是“自动修复”，而是让脚本停下来等待人工判断。先用 dry-run 观察数量，再把阈值设成业务能接受的上限。

需要可恢复空间时，可考虑 --backup --backup-dir=/srv/rsync-trash，让被覆盖或删除的目标文件进入备份目录，而不是立即消失。备份目录要单独规划容量和权限；相对路径会相对于目标目录解析，跨远端 daemon 时也不能随意跑出模块范围。

复用同一条命令再正式同步

预览确认后，复制刚才的命令，只移除 -n，其他参数保持不变：

rsync -aiv --delete --max-delete=50 /srv/release/ backup@backup01:/srv/app/
# 正式执行前不要改源/目标路径；超过 50 个删除时让 rsync 以错误退出

脚本里应检查 rsync 的退出码：0 表示成功，23/24 表示部分传输或源文件消失，25 表示删除数量护栏触发。遇到非 0 先保留 dry-run 输出和命令参数，别为了“跑通”直接加 --ignore-errors；该选项会允许发送端出现 I/O 错误时继续删除目标端内容。

常见问题

dry-run 里没有看到删除项怎么办？

先确认用了完整目录而不是 dir/*，再确认源端挂载和权限正常；同时检查 exclude 是否保护了目标文件。

只想预览删除，不想预览复制怎么办？

可以继续使用 --dry-run --delete，阅读输出中的 *deleting 行；不要把 --delete 换成普通 rm，两者的范围规则不同。

dry-run 和正式执行的清单一定一样吗？

只有源端、目标端、过滤规则和文件状态没有变化时才应一致。正式执行前如果有发布进程继续写文件，应该重新 dry-run。