要实现目标目录与源目录的镜像同步，必须使用 rsync -av --delete 源/ 目标/，其中源路径末尾斜杠表示同步内容而非目录本身，--delete 删除目标端多余文件，配合 --dry-run 验证和 --exclude 保护本地文件。
要让目标目录与源目录保持绝对一致的镜像状态，核心是使用 --delete 参数，并配合正确的同步模式和路径写法。
必须加 --delete 且明确同步方向
rsync 默认只做“单向复制”，不会删除目标端多余文件。启用镜像效果的关键一步，就是显式加上 --delete。它会让 rsync 在同步完成后，扫描目标目录，把源目录里没有、但目标目录里存在的所有匹配文件或子目录全部删掉。
- 命令格式固定为：
rsync -av --delete 源/ 目标/ - 注意源路径末尾的 /：它表示“同步该目录下的内容”，而不是整个目录本身；不加斜杠会把源目录名也同步进去，影响 exclude 路径匹配和删除逻辑
- 方向不可反：镜像是“以源为权威”，所以一定是源 → 目标；反过来会导致源被清空
用 --dry-run 先验证再执行
--delete 是不可逆操作，误配可能直接删掉关键配置或数据。强烈建议每次正式运行前，先加 --dry-run（或 -n）模拟执行：
- 它会完整列出将要传输、更新、删除的文件，但不做任何实际改动
- 重点检查“deleting xxx”行是否包含你不希望删除的文件
- 确认无误后再去掉 --dry-run，真正执行
排除本地专属文件，避免被误删
镜像同步时，如果目标端有本地独有配置（如 .env、local.conf、secrets.yaml），它们不在源目录中，--delete 默认会把它们删掉。
- 用 --exclude 显式声明这些文件，例如：
--exclude='.env' --exclude='config/local/' - 所有 --exclude 参数必须写在 源路径和目标路径之间，顺序错就失效
- 排除规则基于目标端的相对路径：比如同步
/app/，那么--exclude='.env'就指/app/.env - 不要用 --delete-excluded：它会把被 exclude 的文件也从目标端删掉，违背保护初衷
推荐搭配的常用选项
生产环境建议组合使用以下参数，兼顾安全、可读和完整性：
- -a：归档模式，保留权限、属主、时间戳等元信息
- -v：显示详细过程，便于排查
- --delete：实现镜像一致性
- --dry-run：首次或变更后必加，确认行为
- --exclude：保护本地敏感文件
