macOS合并同名文件夹需手动选择策略：终端可用rsync（智能同步）、ditto（保留元数据）；Finder拖拽选“合并”递归处理；第三方工具ForkLift支持差异预览与精细控制。
如果您在 macOS 系统中需要将多个同名文件夹合并为一个，系统默认不会自动覆盖或智能整合内容，而是提示“文件已存在”，此时需明确操作策略以避免数据丢失或重复覆盖。以下是实现快速合并并理解覆盖规则的具体方法：
一、使用终端命令行合并（rsync 方式）
rsync 是 macOS 内置的高效同步工具，支持增量复制与智能覆盖，可保留修改时间、权限等元数据，并跳过已存在且内容一致的文件。
1、打开“终端”应用程序。
2、输入命令格式：rsync -av --ignore-existing 源文件夹路径/ 目标文件夹路径/（注意末尾斜杠含义：带斜杠表示复制内容，不带表示复制文件夹本身）。
3、若需覆盖目标中较旧的文件，将 --ignore-existing 替换为 --update；若强制覆盖所有同名文件，使用 --force 参数。
4、按回车执行，终端将逐项显示同步过程，完成即停止。
二、使用终端命令行合并（ditto 方式）
ditto 是 Apple 官方推荐的归档与合并工具，原生支持资源分支（resource fork）、扩展属性（xattr）及 ACL 权限，适用于需完整保留 macOS 特有元数据的场景。
1、在终端中输入命令：ditto -V 源文件夹路径 目标文件夹路径（-V 参数启用详细输出模式）。
2、当遇到同名文件时，ditto 默认以源文件覆盖目标文件；若目标文件更新，则不覆盖，除非添加 --noqtn 或配合其他标志控制行为。
3、执行后无交互提示，直接完成合并，输出日志中会列出被覆盖或跳过的项目。
三、通过 Finder 手动拖拽合并（覆盖确认模式）
Finder 在拖入同名文件夹时触发系统级覆盖逻辑，其规则由 macOS 文件协调框架（NSFileManager）控制，覆盖行为取决于用户在弹窗中的选择。
1、在 Finder 中选中待合并的多个源文件夹（可按住 Command 多选）。
2、将其拖拽至目标文件夹内松手，系统弹出对话框：“文件夹 ‘XXX’ 已存在。你想替换它，还是将其合并？”
3、点击 “合并” 按钮，系统将逐层比对子项：同名文件夹递归合并，同名普通文件默认以新修改日期者保留，但不提供版本比较或内容差异提示。
4、若目标中存在只读文件，系统会要求输入管理员密码才能覆盖。
四、使用第三方应用 ForkLift 实现可视化合并
ForkLift 是支持双面板操作的 macOS 文件管理器，内置智能同步引擎，可预览差异、勾选特定项、设置精细覆盖策略。
1、安装并启动 ForkLift，左侧打开源文件夹，右侧打开目标文件夹。
2、点击工具栏“同步”按钮，进入同步配置界面。
3、在“冲突解决”选项中选择：“用左侧覆盖右侧” 或 “跳过已存在文件” 或 “仅更新较新文件”。
4、勾选“显示差异”后点击“开始同步”，界面实时列出每一项操作类型（复制、跳过、覆盖），确认后执行。
五、同名文件夹合并覆盖核心规则说明
macOS 对同名文件夹的合并行为并非统一策略，而是依调用接口不同而异：Finder 合并基于 NSFileManager 的 replaceItemAtURL 方法，默认保留目标文件夹属性；rsync 以字节级时间戳和大小判断是否跳过；ditto 则优先保障 HFS+/APFS 元数据完整性。
1、文件级覆盖判定依据为：文件名完全相同且位于相同相对路径下。
2、文件夹内嵌套结构被递归处理，但不会自动重命名冲突文件（如 file.txt → file 2.txt）。
3、ACL 权限、扩展属性（如 com.apple.quarantine）、资源分支在 ditto 和 rsync（加 -X 参数）下可保留，Finder 合并则可能丢失部分属性。
