ParrelSync安全注意事项：避免数据丢失和项目损坏的完整指南

ParrelSync是Unity开发中极为实用的工具，能够在不构建的情况下测试多人游戏功能，但如果不正确使用，可能会面临数据丢失和项目损坏的风险。本文将为您详细介绍使用ParrelSync时需要关注的安全要点，确保您的开发过程既高效又安全。✨

🔒 核心安全设置：禁用克隆编辑器中的资产保存

强烈推荐启用：在ParrelSync的偏好设置中，务必启用"在克隆编辑器中禁用资产保存"选项。这个设置可以防止在克隆项目中意外修改资产，所有资产修改都只能在原始项目编辑器中进行。

在ParrelSync/Editor/Preferences.cs文件中，这个关键安全设置被定义为：

public static BoolPreference AssetModPref = new BoolPreference("ParrelSync_DisableClonesAssetSaving", true);

启用此功能后，即使您不小心在克隆编辑器中尝试保存资产，系统也会阻止此操作，从而避免数据不一致问题。

⚠️ 符号链接文件夹的安全边界

在使用ParrelSync的符号链接功能时，必须确保所有链接文件夹都位于项目目录内。系统会严格检查这一边界条件：

if (result.Contains(projectPath))
{
    optionalFolderPaths[i] = result.Replace(projectPath,"");
    optionalFolderPathsAreDirty = true;
}
else if( result != "")
{
    Debug.LogWarning("Symbolic Link folder must be within the project directory");
}

重要提醒：如果尝试链接项目目录外的文件夹，系统会发出警告并拒绝操作，这是防止项目结构混乱的重要安全机制。

🔍 文件夹完整性验证机制

ParrelSync内置了强大的完整性检查系统，位于ParrelSync/Editor/ValidateCopiedFoldersIntegrity.cs，该系统使用MD5哈希算法验证克隆项目与原始项目之间文件夹的一致性。

文件夹完整性验证

当检测到文件夹内容不一致时，系统会自动更新克隆项目：

if (targetFolderHash != originalFolderHash)
{
    Debug.Log("ParrelSync: Detected changes in '" + folderName + "' directory. Updating cloned project...");
    FileUtil.ReplaceDirectory(originalFolderPath, targetFolderPath);
}

🚨 潜在风险与预防措施

1. 库文件夹复制风险

在复制Library文件夹时，如果目标路径已存在，系统会发出警告：

if (Directory.Exists(destinationProject.libraryPath))
{
    Debug.LogWarning("Library copy: destination path already exists! ");
    return;
}

预防措施：在创建新克隆前，确保之前的克隆项目已完全删除，避免文件冲突。

2. Unity锁文件状态检查

在Windows编辑器中，可以启用"同时检查UnityLockFile锁定状态"选项，这有助于：

• 准确检测克隆项目的运行状态
• 防止在克隆项目仍在运行时意外删除
• 避免编辑器崩溃后状态显示错误

🛡️ 最佳实践清单

✅ 定期备份原始项目 - 在进行大量克隆操作前，确保原始项目有完整备份

✅ 使用推荐的安全设置 - 始终启用"禁用克隆编辑器中的资产保存"

✅ 检查符号链接边界 - 确保所有链接文件夹都在项目目录内

✅ 验证文件夹完整性 - 利用内置的MD5验证机制确保数据一致性

✅ 正确关闭克隆项目 - 在删除克隆前，确保所有克隆编辑器已完全关闭

✅ 监控控制台警告 - 关注所有与ParrelSync相关的警告信息

💡 紧急情况处理

如果遇到克隆项目无法正常打开或出现数据不一致的情况：

1. 首先关闭所有Unity编辑器实例
2. 通过ParrelSync的克隆管理器删除有问题的克隆
3. 重新创建克隆项目
4. 如果问题持续存在，检查原始项目的完整性

通过遵循这些安全注意事项和最佳实践，您可以充分利用ParrelSync的强大功能，同时最大程度地降低数据丢失和项目损坏的风险。记住，安全使用工具比快速完成任务更重要！🎯