Linux-rsync

rsync 是 Linux 中用于增量同步文件和目录的常用命令。本文从语法、常用选项、实用示例和排错方法入手，命令均使用 Bash 高亮并支持一键复制。

快速上手

rsync -avh --progress source/ destination/

基本语法

rsync [选项] [参数]

方括号表示可选内容。实际使用时不要输入方括号；多个选项通常可以合并，但应以本机 rsync --help 或手册页为准。

常用选项

选项/子命令	作用
-a	归档模式
-v	显示详情
-h	易读单位
-z	传输时压缩
--delete	删除目标多余文件

实用示例

示例 1

rsync -avh source/ backup/

复制上面的命令后，可先核对路径、文件名、用户和主机参数，再在终端执行。

示例 2

rsync -avz --progress site/ user@192.0.2.10:/var/www/site/

复制上面的命令后，可先核对路径、文件名、用户和主机参数，再在终端执行。

示例 3

rsync -avhn --delete source/ mirror/

复制上面的命令后，可先核对路径、文件名、用户和主机参数，再在终端执行。

查看帮助

rsync --help
man rsync

不同发行版或工具版本的参数可能略有差异。脚本化使用前，建议先用测试目录验证结果；涉及覆盖、删除、权限或服务状态的操作，应先备份并检查命令展开后的目标。

常见问题

提示 command not found 怎么办？

先确认命令是否安装，再用 command -v rsync 查找路径，并通过发行版的软件包管理器安装缺失组件。

提示 Permission denied 怎么办？

检查当前用户、文件权限和父目录权限。只有确实需要系统权限时才使用 sudo，不要把扩大权限当作默认处理方式。

如何确认执行结果？

观察标准输出和错误输出，并运行 echo $? 查看上一条命令的退出状态；通常 0 表示成功，非 0 表示发生错误。

总结

掌握 rsync 的核心语法、常用选项与退出状态，就能更稳定地完成增量同步文件和目录。建议把常用组合保存为个人速查表，并在自动化脚本中加入参数检查和错误处理。