Floccus书签同步工具中Git分支修改问题的分析与解决

Floccus是一款优秀的浏览器书签同步工具，支持通过多种方式同步书签数据。在使用Git作为同步后端时，开发者发现了一个影响用户体验的配置问题：一旦创建了同步配置后，无法修改Git分支设置。

问题现象

当用户创建Floccus的Git同步配置时，工具默认会使用"main"作为分支名称。然而在某些情况下，用户的Git仓库可能使用的是传统的"master"分支或其他自定义分支名称。此时用户会遇到以下问题：

1. 初始配置时如果忘记修改分支名称，后续无法通过编辑配置来修正
2. 尝试修改分支名称并保存后，配置会自动恢复为原来的"main"分支
3. 导致同步失败，因为指定的分支在远程仓库中不存在

技术原因分析

经过开发者排查，这个问题源于配置保存逻辑中的一个bug。当用户编辑现有配置时，分支名称字段的值没有被正确处理和保存。具体表现为：

• 前端界面允许用户修改分支名称字段
• 但提交保存时，后端没有正确接收并存储这个修改
• 导致配置保存后，分支名称恢复为原始值

解决方案

该问题已在代码库中修复，修复提交为89490cf。主要修改点是确保配置编辑时分支名称字段能够被正确保存。这个修复将包含在下一个发布的版本中(V5.2.2或更高版本)。

临时解决方案

在修复版本发布前，遇到此问题的用户可以采取以下临时解决方案：

1. 删除现有的同步配置
2. 重新创建配置，确保在初始设置时就输入正确的分支名称
3. 虽然会重新同步一次数据，但可以确保使用正确的分支

最佳实践建议

为了避免此类问题，建议用户：

1. 在首次创建Git同步配置时，仔细检查所有参数
2. 特别是分支名称、仓库URL等关键信息
3. 可以先进行测试同步，确认配置正确后再正式使用
4. 关注Floccus的版本更新，及时升级到修复版本

总结

配置参数的持久化存储是同步工具的核心功能之一。Floccus团队及时响应并修复了这个Git分支配置问题，体现了对用户体验的重视。用户在使用时应注意初始配置的准确性，并保持软件更新，以获得最佳的使用体验。