GitJournal文件删除同步问题的技术分析与解决方案

问题背景

GitJournal是一款基于Git的笔记应用，在1.87.0版本中出现了严重的文件删除同步问题。当用户通过外部Git客户端删除文件并推送后，GitJournal在同步时会错误地将已删除的文件重新添加回仓库，导致所谓的"僵尸文件"问题。

问题本质

这个问题的根本原因在于GitJournal从libgit2迁移到dart-git后，合并算法的实现存在缺陷。具体表现为：

1. 当外部删除操作与本地操作合并时，删除操作没有被正确处理
2. 合并冲突解决策略不够完善，导致被删除的文件被错误保留
3. 同步机制没有正确处理远程仓库的删除变更

技术细节分析

合并算法缺陷

dart-git的合并实现相比libgit2不够完善，特别是在处理删除操作时。当远程仓库有文件删除而本地没有对应变更时，合并过程没有正确识别并应用这些删除操作。

同步流程问题

GitJournal的同步流程在检测到Git引用不存在时(GitRefNotFound异常)的处理逻辑可能存在问题，导致没有正确处理删除操作。这体现在repository.dart文件的特定异常处理逻辑中。

底层依赖问题

迁移到dart-git后，还遇到了Dart SDK的zlib解码器回归问题，影响了pack文件的读取，这进一步复杂化了问题的解决过程。

解决方案

开发者已经采取了以下措施：

1. 在dart-git中修复了合并算法的实现
2. 对于Android平台，通过降级Flutter版本临时解决了问题
3. 计划在后续版本中升级Flutter并包含完整修复

临时解决方案

对于遇到此问题的用户，可以采取以下临时措施：

1. 始终通过GitJournal应用内部删除文件，而不是通过外部Git客户端
2. 在批量删除前断开Git仓库连接，删除完成后再重新连接
3. 考虑使用其他Git客户端(如MGit)配合文本编辑器作为临时替代方案

经验教训

这个案例展示了几个重要的技术经验：

1. 核心功能依赖第三方库时需要考虑兼容性和替代方案
2. 版本升级需要全面测试核心功能
3. 文件同步类应用需要特别注意删除操作的处理
4. 跨平台开发中底层依赖的稳定性至关重要

未来展望

随着dart-git的持续改进和Flutter版本的稳定，这个问题有望得到彻底解决。对于笔记类应用而言，可靠的同步机制是核心功能，开发者需要持续关注和优化这一方面。