Mac用户需先用Homebrew安装rsync并验证版本≥3.1.0；支持本地外接硬盘（注意挂载与NTFS写入权限）和远程SSH同步（需配置免密登录）；可排除指定文件、设置launchd定时任务。
一、确认rsync已安装并验证可用性
Mac系统通常不预装rsync，需通过Homebrew安装；若未安装，终端将提示“command not found”。安装后需验证版本及执行权限，确保后续同步命令可正常解析。
1、打开“终端”应用程序。
2、输入which rsync检查是否已存在；若返回空行，则未安装。
3、若未安装，先运行brew --version确认Homebrew可用；如未安装Homebrew，执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装。
4、执行brew install rsync完成安装。
5、运行rsync --version确认输出版本号（应高于3.1.0），表示安装成功。
二、同步文件到外接硬盘（本地路径间同步）
rsync支持任意两个本地路径间的高效同步，对外接硬盘使用时需确保其已正确挂载且具有读写权限；-a参数保留文件属性，-v提供可见反馈，--delete可选清理目标端冗余项。
1、在“访达”中确认外接硬盘名称（例如显示为“BACKUP_DISK”）。
2、打开终端，执行ls /Volumes/查看挂载点是否列出该硬盘名称。
3、假设源目录为~/Documents/project，目标为外接硬盘根目录下的project_backup文件夹，则运行：
rsync -av --delete ~/Documents/project/ /Volumes/BACKUP_DISK/project_backup/
4、注意末尾斜杠：源路径带/表示同步内容而非整个目录；目标路径带/确保写入指定文件夹内。
5、首次运行将全量复制；后续运行仅传输变更文件，实现真正增量同步。
三、同步文件到远程服务器（SSH协议同步）
rsync通过SSH加密通道传输数据，无需额外守护进程；要求本地与远程均安装rsync，并已配置SSH免密登录以避免交互式密码输入，保障脚本化与自动化可行性。
1、在终端执行ssh-keygen -t ed25519生成密钥对（连续按回车使用默认路径和空密码）。
2、运行ssh-copy-id user@server_ip（替换user与server_ip）将公钥上传至服务器；若该命令不可用，手动执行cat ~/.ssh/id_ed25519.pub | ssh user@server_ip "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"。
3、测试免密登录：ssh user@server_ip，成功进入即退出。
4、执行同步命令，例如将本地~/Sites/myapp同步至服务器/var/www/myapp：
rsync -avz -e "ssh -o StrictHostKeyChecking=no" ~/Sites/myapp/ user@server_ip:/var/www/myapp/
5、若服务器SSH端口非22，需在-e参数中显式指定，例如-e "ssh -p 2222"。
四、跳过特定文件或目录的同步
实际备份中常需排除缓存、临时文件、日志等非必要内容，避免冗余传输与空间占用；rsync提供--exclude与--exclude-from两种方式灵活控制过滤规则。
1、单次排除：在rsync命令末尾添加--exclude '.DS_Store' --exclude 'node_modules/' --exclude '*.log'。
2、批量排除：新建文本文件rsync_exclude.txt，每行一个模式（如.git/、__pycache__/、*~），保存后在命令中引用：--exclude-from="$HOME/rsync_exclude.txt"。
3、排除规则区分大小写，路径匹配基于源路径相对结构；/开头表示绝对路径匹配（仅适用于远程模块方式，SSH下无效）。
4、使用--dry-run参数先行模拟运行，终端将列出所有将被处理的文件，确认排除生效后再移除该参数执行真实同步。
五、设置定时自动同步（launchd方式）
macOS推荐使用launchd替代cron管理后台任务，通过plist配置文件定义触发条件与执行环境，确保用户登录后或定期唤醒时可靠运行rsync命令。
1、在终端创建配置目录：mkdir -p ~/Library/LaunchAgents。
2、使用nano编辑器创建plist文件：nano ~/Library/LaunchAgents/com.user.rsync-backup.plist。
3、粘贴以下内容（请将YOUR_SOURCE、YOUR_DEST、USER替换为实际值）：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.user.rsync-backup</string>
<key>ProgramArguments</key>
<array>
<string>rsync</string>
<string>-av</string>
<string>--delete</string>
<string>YOUR_SOURCE/</string>
<string>YOUR_DEST/</string>
</array>
<key>StartCalendarInterval</key>
<dict>
<key>Hour</key>
<integer>2</integer>
<key>Minute</key>
<integer>30</integer>
</dict>
<key>RunAtLoad</key>
<true/>
<key>StandardOutPath</key>
<string>/Users/USER/Library/Logs/rsync-backup.log</string>
<key>StandardErrorPath</key>
<string>/Users/USER/Library/Logs/rsync-backup-error.log</string>
</dict>
</plist>
4、保存退出（Ctrl+O → Enter → Ctrl+X）。
5、加载任务：launchctl load ~/Library/LaunchAgents/com.user.rsync-backup.plist。
6、立即运行一次测试：launchctl start com.user.rsync-backup；检查日志文件确认无报错。
六、处理NTFS格式外接硬盘的写入权限问题
macOS原生仅支持NTFS只读，若外接硬盘为NTFS格式且需写入，必须启用第三方驱动或转换挂载方式；否则rsync将因“Permission denied”失败，即使磁盘在访达中显示可写。
1、在终端执行diskutil list识别NTFS硬盘对应标识符（如disk2s1）。
2、运行sudo diskutil info /dev/disk2s1 | grep "File System Personality"确认文件系统为NTFS。
3、若未安装NTFS写入驱动，推荐安装Paragon NTFS for Mac或Tuxera NTFS商业方案；开源方案如ntfs-3g需配合macOS FUSE（FUSE for macOS），但稳定性与兼容性较低。
4、安装驱动后重启，重新插拔硬盘；再次运行ls -l /Volumes/，确认目标卷权限字段含drwxrwxrwx且属主非root。
5、若仍遇权限错误，临时修复挂载选项：卸载后以读写方式重挂载（需先卸载sudo diskutil unmount /Volumes/DRIVE_NAME），再执行sudo mkdir /Volumes/NTFS_RW && sudo mount -t ntfs -o rw,auto,nobrowse /dev/disk2s1 /Volumes/NTFS_RW，随后将rsync目标路径指向/Volumes/NTFS_RW。
