rsync 源目录末尾加不加斜杠有什么区别

rsync 源目录最后有没有 /，决定的是“复制目录本身”还是“复制目录里的内容”。例如源路径是 /srv/release/app，目标是 /srv/backup：不加斜杠通常得到 /srv/backup/app/...；加上斜杠则把 app 里面的文件直接放进 /srv/backup/。这不是格式习惯，而是目标目录层级的一部分。

rsync 末尾斜杠先看目标目录的角色

先问一个比“要不要加斜杠”更准确的问题：目标路径是接收整个项目，还是已经是项目目录？假设发布包位于 /srv/release/app，备份根目录位于 /srv/backup，若希望备份后能看到 /srv/backup/app，源路径不要加斜杠；若 /srv/backup 已经被脚本当作应用目录，希望里面直接出现 index.html 和 config/，源路径要加斜杠。

可以把规则记成一句话：app 代表“把这个目录搬过去”，app/ 代表“把这个目录的内容放过去”。两种写法都会递归处理内容，但目标树的第一层不同。

不加斜杠时，复制的是源目录本身

命令如下：

rsync -av /srv/release/app /srv/backup

这里的目标结果是：

/srv/backup/app/index.html
/srv/backup/app/config/
/srv/backup/app/static/

当备份根目录下还会放置多个版本或多个服务时，这种写法更直观，因为源目录名仍然保留。运维脚本常用它把 app、worker、docs 等多个目录并列放入同一个备份根目录。

注意目标 /srv/backup/app 是否已经存在并不会改变“不带斜杠代表源目录本身”的语义；它只影响 rsync 如何合并同名目录。真正容易出错的是把目标写成已经代表 app 的路径，却仍然使用不带斜杠的源路径，最后得到多余的 app/app 层级。

加上斜杠时，只同步源目录里的内容

如果目标目录本身就是应用目录，使用：

rsync -av /srv/release/app/ /srv/backup/app/

等价的目标内容是：

/srv/backup/app/index.html
/srv/backup/app/config/
/srv/backup/app/static/

也可以把内容同步到备份根目录：

rsync -av /srv/release/app/ /srv/backup/

此时 index.html 直接位于 /srv/backup/ 下。官方 rsync 手册把它概括为“源目录带末尾斜杠时复制目录内容”，同时包含目录属性的处理。远程源也遵循同一判断，例如 host:/srv/release/app/ 与本地源路径的层级规则一致。

生产脚本用 dry-run 防止多一层目录

部署或备份脚本不要直接凭肉眼判断，先查看将要处理的文件列表：

rsync -anv --delete /srv/release/app/ /srv/backup/app/

-n（--dry-run）只模拟，-v 输出路径；重点检查输出是否以目标预期的第一层开始。确认无误后再去掉 -n。若目标目录写错，dry-run 能发现层级问题，但它不会替你判断删除是否安全。

使用 --delete 时尤其要先确认末尾斜杠。它会让目标多余文件按同步范围被删除：源是 app/，目标是 /srv/backup/app/，删除范围通常是该应用目录；如果目标误写成共享备份根目录，风险会扩大。稳妥的回滚方式是先取消 --delete 做一次内容恢复，或把目标目录改名留存，再从最近一次正确备份恢复。

排查时可以按这个顺序：先确认源目录实际存在，再确认目标路径代表“容器”还是“项目目录”，然后运行 dry-run，最后才执行正式同步。脚本中把源、目标和是否带斜杠写成注释，能减少后续维护者把两种语义改反。

常见问题

rsync 源目录加不加斜杠会复制文件内容吗？

会，递归复制的文件内容可以相同；主要差异是目标树是否多出源目录名这一层。

目标目录不存在时，两种写法还一样吗？

不一样。目标路径的创建与合并会受源操作数影响，不能因为目标当前不存在就忽略斜杠语义，先用 dry-run 看路径。

rsync 远程复制也遵循这条规则吗？

遵循。把本地源换成 user@host:/srv/release/app 或带斜杠的形式，目录名与内容的差别仍然存在。

因此，记忆重点不是“目录后面永远加斜杠”，而是先确认目标路径是否已经承担源目录的名字：需要保留 app 就不加，需要把内容填入现有 app 就加，再用 rsync -anv 做最后一次路径核对。