数据目录、备份与恢复

本页快捷入口：找到数据目录 · 网盘目录风险 · 数据库恢复 · 版本兼容

红豆的数据目录包含本地数据库、附件文件、全文索引和部分设置。同步可以帮助跨设备使用，但不能代替可独立恢复的本地备份。

找到当前数据目录

打开“设置 → 高级 → 文件和文件夹”，使用“显示数据目录”进入红豆当前实际使用的目录。不要仅根据默认路径猜测，因为用户可能设置了自定义位置。

数据目录通常包含：

• zotero.sqlite：题录、分类、笔记、标签等文献数据库（文件名沿用底层项目标识）；
• storage：由红豆管理的存储附件；
• zotero.sqlite.bak 等数据库自动备份文件；
• 全文索引及其他运行数据。

创建完整备份

1. 等待同步完成。
2. 完全退出红豆。
3. 复制整个数据目录到另一个磁盘或可靠的备份位置。
4. 确认数据库文件和 storage 目录都已复制。
5. 为备份记录日期、红豆版本和操作系统。

只复制导出的 RIS 或 BibTeX 文件不能完整保留分类、笔记、附件、关联条目和同步状态。

从备份恢复

1. 在当前红豆中确认实际数据目录位置，并先关闭自动同步。
2. 退出红豆，并先备份现有目录。
3. 将要恢复的完整备份放到正确位置。
4. 启动红豆，检查条目、分类、笔记和附件。
5. 确认恢复内容正确后再决定同步方向。普通同步可能将服务器上的后续修改重新合并进来；如确需覆盖在线文库，先阅读同步重置说明。

自动数据库备份

红豆通常会在数据目录中保留最近的数据库备份文件。自动备份主要保护数据库，不一定包含附件，因此不能替代整个目录备份。

重要提醒

• 不要在红豆运行时直接替换数据库文件；
• 不要用网盘的“仅在线”状态存放正在使用的数据库；
• 切换账号、迁移电脑、修改数据目录或执行覆盖同步前先备份；
• 数据库损坏或同步冲突时，保留现场文件和日志，不要反复覆盖尝试。

迁移数据目录与更换电脑

“数据目录”与“链接附件根目录”用途不同。修改数据目录会影响整套本地文库；修改链接附件根目录只改变外部附件路径的解析。

迁移时先备份、完全退出红豆，然后复制整个目录，在设置中选择已有目录并按提示重启。只有确认新目录中的条目、笔记和附件正常后，才清理旧位置。链接附件保存在外部目录，应单独迁移。账号凭据、部分偏好和插件配置可能位于用户配置文件中，不一定随数据目录一起转移。

为什么不能把数据目录放进实时同步网盘

正在使用的 SQLite 数据库和事务文件需要由同一应用协调写入。OneDrive、iCloud、Dropbox 等文件级同步工具可能同时上传不同时间的数据库与日志，或在多台设备间产生冲突副本，导致文库损坏。

把活动数据目录放在本机普通目录，通过红豆同步共享题录，通过红豆云存储或 WebDAV 同步存储附件。可以在红豆完全退出后，将完整备份放到网盘。不要让正在使用的数据目录处于“仅在线”状态，也不要同时从两台机器打开同一份活动数据库。

数据库损坏时的恢复顺序

1. 停止反复启动或同步，先保存当前整个数据目录，连同 .damaged、-wal、-journal 等现有文件；不要自行删除事务文件。
2. 若应用提示从最近自动数据库备份恢复，核对显示的备份时间，再决定是否接受。备份之后新增的数据可能丢失。
3. 有完整目录备份时，优先按上面的恢复步骤操作。数据库自动备份仅保护题录等数据库内容，并不包含独立的附件副本。
4. 恢复后检查条目数量、最近修改的笔记及附件。先保持自动同步关闭，确认恢复结果后再决定如何与云端合并。
5. 没有可用备份，或恢复后仍提示损坏时，保留原文件并向红豆支持反馈；不要把私人数据库上传到与红豆无关的在线修复工具。

如果只是附件全文搜索异常，而题录能正常打开，应先排查全文索引，不要直接替换主文献数据库。

数据库版本比应用更新

这通常表示数据目录曾被更新版本或测试版本打开。旧应用无法安全读取已经升级的数据库。

先保留完整备份，然后从红豆下载入口安装能够读取该数据目录的相同或更新版本。不要修改数据库里的版本数字强行启动，也不要用 Zotero 官方安装包替代红豆来打开当前文库。若确需回退程序，应使用升级前的独立备份，并先咨询支持确认兼容性。

用户配置目录与文献数据目录

用户配置目录（profile）保存偏好、插件配置等应用环境；文献数据目录保存数据库和管理的附件。它们可能位于不同位置。需要完整迁移时，先记录已安装插件、同步与路径设置，文献数据按本页完整目录迁移，应用配置按当前版本重新核对。

不要让两个红豆实例同时写同一个数据目录；开发或隔离测试使用独立目录。迁移已有论文所依赖的文库时，优先复制完整数据库或使用支持的同步流程：导出 RIS／BibTeX 再导入会创建新的条目标识，可能使 Word／WPS 等旧引文失去本地关联。

按需下载的附件可能尚未存在本机。备份前，先让一台设备完整下载需要保留的附件；外部链接文件另行备份。只复制 storage 文件夹不能恢复题录、分类和笔记数据库。