使用rsync对比本地与iCloud Drive文件夹时遇在线文件命名异常

我来帮你搞定这个头疼的命名差异问题！首先得搞清楚：那些带.icloud后缀的隐藏文件，其实是iCloud Drive的仅在线文件占位符——它们不是实际的文件内容，只是指向云端文件的轻量链接，所以系统自动把命名改成了.原文件名.icloud的格式，这才导致rsync没法正常匹配。

下面给你两种实用的解决方案，按需选择：

方案1：先把云端文件下载到本地（最稳妥） #

如果你想直接对比真实的文件内容，最省心的方式是先让iCloud把所有仅在线的文件下载到本地：

• 打开Finder，找到你的iCloud Drive目标文件夹
• 右键点击文件夹，选择**「下载全部」**（或者选中所有带云图标的文件，右键点「下载」）
• 等所有文件下载完成后，iCloud里的文件名会和本地完全一致，这时rsync就能正常对比了。

给你个rsync对比的示例命令（假设本地文件夹是~/Local-Files，iCloud目标文件夹是~/Library/Mobile Documents/com~apple~CloudDocs/Cloud-Files）：

# -n是模拟运行，只显示差异不实际修改，适合先排查；去掉-n就是实际同步
rsync -avn ~/Local-Files/ ~/Library/Mobile Documents/com~apple~CloudDocs/Cloud-Files/

方案2：处理占位符文件名，无需全量下载（适合大文件场景） #

如果文件太多不想全量下载，你可以通过脚本提取占位符里的原文件名，再和本地文件做匹配对比。比如这个简单的bash脚本：

# 遍历iCloud里的占位符文件，逐个匹配本地文件
for placeholder in ~/Library/Mobile Documents/com~apple~CloudDocs/Cloud-Files/.*.icloud; do
    # 从占位符文件名里提取原文件名（去掉开头的.和结尾的.icloud）
    original_file=$(basename "$placeholder" .icloud | sed 's/^\.//')
    if [ -f "~/Local-Files/$original_file" ]; then
        echo "✅ 本地存在匹配文件：$original_file"
        # 这里可以添加rsync对比元数据的逻辑，或者用diff查看细节
    else
        echo "❌ 本地缺少文件：$original_file"
    fi
done

额外小贴士 #

• 注意iCloud Drive的真实路径是~/Library/Mobile Documents/com~apple~CloudDocs/，尽量用这个路径给rsync，别直接用Finder显示的「iCloud Drive」快捷路径，避免识别问题
• 如果经常需要同步这个文件夹，建议在iCloud设置里把它设为**「下载并保留在我的Mac上」**，这样就不会生成占位符，rsync以后就能直接正常工作了

内容的提问来源于stack exchange，提问作者Claytinho