Zotero 数据库迁移:换电脑保留 PDF、笔记和引用的安全方法
简答:Zotero 数据库迁移最稳妥的闭环是:先确认当前 Data Directory,关闭旧电脑和新电脑上的 Zotero,复制完整数据目录或使用同步,再分别检查条目、PDF、笔记、标签、链接附件和文字处理器插件。不要只复制 zotero.sqlite,也不要把正在使用的数据目录放进 Dropbox、Google Drive、OneDrive 或其他实时同步文件夹。
定义:Zotero 数据库迁移,是将本地文库数据库、已存储附件及相关数据从旧电脑、旧磁盘或备份位置恢复到新环境的过程;它不等于自动迁移所有偏好设置、插件和外部文件路径。
先看速查卡:数据库、附件、设置分别怎么迁移?
先判断你要迁移的对象。Zotero 的 zotero.sqlite 主要保存条目元数据、笔记和标签,storage 文件夹保存已存储的 PDF、网页快照和其他附件;链接附件则只保存原文件路径,不会因为数据库复制而自动复制文件。Zotero 数据目录说明对此有明确区分。
| 对象 | 完整复制数据目录 | 使用 Zotero Sync | 迁移后是否要单独核对 |
|---|---|---|---|
| 条目、收藏夹、标签、笔记 | 会随数据库复制 | 通过数据同步恢复 | 要抽查数量、最近新增条目和笔记 |
| 已存储 PDF、网页快照 | 随 storage 复制 | 需启用 Zotero Storage 或 WebDAV 文件同步 | 要随机离线打开附件 |
| 链接附件 | 只保留链接,不复制原文件 | 不会由 Zotero 文件同步处理 | 要检查原文件路径或设置链接附件基目录 |
| 偏好设置 | 不能假定全部迁移 | 不能假定全部同步 | 要重新核对同步、附件、引用和高级设置 |
| 插件与文字处理器插件 | 不能假定在新电脑可用 | 不能替代新电脑上的安装 | 要重新安装或检查启用状态 |
最快判断:换电脑整库迁移,优先选择“同步”或“关闭 Zotero 后复制完整数据目录”;只迁移部分条目时才考虑导出/导入。导出格式不能完整保留整库结构,重新导入还可能影响已有文字处理器文档中的引用连接。Zotero 跨电脑迁移说明
迁移前:确认数据目录、备份和文件状态
- 打开当前数据目录。Windows 和 Linux 进入
Edit → Settings,macOS 进入Zotero → Settings,也可以使用Ctrl/Cmd + ,打开设置。然后进入Advanced → Files and Folders,点击Show Data Directory。这个入口比手动猜默认路径更可靠。Zotero 设置说明 - 记录系统路径。Windows 7 及更高版本的默认目录通常是
C:\Users\用户名\Zotero,macOS 通常是/Users/用户名/Zotero,Linux 通常是~/Zotero;如果你改过位置,以设置页面显示的 Data Directory Location 为准。官方数据目录说明 - 检查本地附件是否真的存在。如果使用文件同步中的“按需下载”,在线库里有附件不代表旧电脑已经保存了完整本地副本。随机断网打开几份 PDF,或在附件同步设置中确认是否选择了同步时下载文件。未下载到本机的附件不能被当作本地完整备份。
- 制作完整备份。退出 Zotero 后复制整个数据目录到另一块存储设备,至少保留
zotero.sqlite、storage和同目录其他文件。不要自行挑选或单独替换zotero.sqlite-wal、zotero.sqlite-shm;正常关闭后直接复制整个目录更稳妥。若程序异常退出或文件仍被占用,先制作只读副本,不要继续覆盖原目录。Zotero 备份建议 - 不要把活动数据库放进网盘或网络盘。Dropbox、Google Drive、OneDrive 等可以作为关闭 Zotero 后的临时复制位置,但不应让多个设备直接读写同一个活动数据目录。Zotero 官方将此类用法列为可能导致数据库损坏或数据丢失的高风险方式。Advanced 设置与数据目录安全说明
方案一:用 Zotero Sync 迁移到新电脑
同步适合旧电脑仍能启动、账户中的在线文库完整,并且你希望新电脑通过网络恢复数据。需要分清两部分:数据同步负责条目、笔记、标签和链接等内容;文件同步负责 PDF、音频、视频和图片等附件。两者不是同一个开关。Zotero 同步说明
- 在旧电脑的
Settings → Sync中确认登录的是正确账户。 - 手动同步,并在在线文库中检查最近新增的条目、收藏夹、标签和笔记。
- 在
Sync → Settings中确认附件使用 Zotero Storage 或 WebDAV。Zotero Storage 是官方推荐的文件同步方式;WebDAV 可用于个人库附件,但群组库附件不适用 WebDAV。 - 如果要让本地保留完整 PDF,检查
Download files设置。选择“同步时下载”更适合制作本地附件副本;“按需下载”会节省磁盘空间,但不能保证旧电脑本地已经有全部附件。同步设置说明 - 在新电脑安装 Zotero,登录同一账户,先等待数据同步,再等待或触发附件同步。
- 随机打开条目、PDF、网页快照、笔记和收藏夹。确认结果前不要格式化旧电脑,也不要删除旧数据。
停止条件:在线文库缺条目、附件数量明显不足、账户无法确认,或同步过程中出现大量删除提示时,先停止,不要继续让新电脑覆盖旧数据,改用完整目录复制或备份恢复。
方案二:关闭 Zotero 后复制完整数据目录
这是换电脑、重装系统或迁移磁盘时最直接的整库方式。它能保留数据库和已存储附件,但不能替代插件安装、文字处理器插件检查,也不能自动修复链接附件在新电脑上的路径。
- 在旧电脑通过
Advanced → Files and Folders → Show Data Directory打开实际目录。 - 完全退出旧电脑上的 Zotero;新电脑如果已启动过 Zotero,也一并退出。
- 将整个数据目录复制到外置硬盘或局域网临时位置。不要只复制
zotero.sqlite,也不要手动删除目录中的临时文件。 - 新电脑若已经生成空库,先将该目录改名或移到安全位置,例如
Zotero-Old,不要直接覆盖而不留回退副本。 - 把旧电脑的完整数据目录复制到新电脑的目标位置。Windows、macOS、Linux 都应以新电脑设置中显示的 Data Directory Location 为准,不要仅凭默认路径操作。
- 启动 Zotero,检查条目和附件。如果显示空库,先退出程序,重新核对数据目录路径和复制层级;常见错误是把“数据目录里面的文件”复制成了多套嵌套目录,或复制到了未被 Zotero 使用的位置。
官方迁移流程明确要求复制前关闭两台设备上的 Zotero;如果新电脑已经启动过程序,需要先处理它生成的空数据目录。跨电脑迁移官方步骤
方案三:从备份恢复,适合旧电脑异常或迁移失败
备份恢复与同步迁移不同:它依赖你已经保存的完整数据目录,适合旧电脑无法正常使用、同步库不完整,或新电脑迁移后需要回退的情况。
- 先确认备份来自哪个时间点,并保留当前新电脑数据目录副本。
- 打开新电脑 Zotero 设置中的
Advanced,记录 Data Directory Location,点击Show Data Directory确认当前目录。 - 退出 Zotero,将当前目录改名为
Zotero-Old或复制到其他位置,不要直接删除。 - 把备份中的完整数据目录复制回原目标位置,再启动 Zotero。
- 检查条目、收藏夹、标签、笔记和附件。确认正确后,暂时保留
Zotero-Old,不要立即清理。 - 如果你使用过同步,恢复后不要立刻重新开启自动同步。在线库中的较新删除或修改可能再次覆盖本地恢复结果;先确认你要保留的是本地版本还是在线版本,再决定是否同步。
自动数据库备份通常只包含数据库内容,不等于附件备份;如果需要恢复 PDF,也必须有包含 storage 或对应附件存储的完整备份。Zotero 数据恢复说明
PDF、WebDAV、外置硬盘和链接附件的区别
| 附件类型 | 保存位置或同步方式 | 新电脑检查方法 |
|---|---|---|
| 存储附件 | 通常位于数据目录的 storage 子目录 | 断网随机打开 PDF、网页快照和其他文件 |
| Zotero Storage | 通过 Zotero 文件同步服务保存 | 确认文件同步完成,再检查新电脑是否能打开附件 |
| WebDAV 附件 | 个人库可使用第三方 WebDAV 文件同步 | 在新电脑重新核对 URL、用户名、密码并点击 Verify Server;第三方 WebDAV 的服务质量需自行确认 |
| 外置硬盘中的数据目录 | 整个数据目录位于外置盘 | 确认盘符或挂载点稳定,避免 Zotero 运行时突然拔盘 |
| 链接附件 | 原文件保存在数据目录之外,只保存路径 | 检查路径;必要时在 Advanced 中设置 Linked Attachment Base Directory |
存储附件通常更适合普通迁移,因为文件由 Zotero 管理;链接附件不会由 Zotero 同步,也不会因为复制数据库而复制原始文件。如果新电脑的目录层级不同,可以在两台电脑设置相应的 Linked Attachment Base Directory,让同一基目录下的链接使用相对路径。附件类型说明 Linked Attachment Base Directory 设置
WebDAV 只负责文件同步,不替代条目数据同步;新电脑仍要登录同一 Zotero 账户并完成数据同步。若 Verify Server 失败,不要反复删除本地附件,先核对服务地址、协议、账户权限和网络连接。
设置、插件和 Word 引用:不能假定会随数据库一起迁移
完整数据目录主要解决数据库和已存储附件迁移,不应笼统理解为“所有 Zotero 设置都会跟着走”。新电脑需要重新核对以下内容:
- 同步设置:账户、数据同步、文件同步、Storage 或 WebDAV 选项,以及附件下载方式。
- 路径设置:Data Directory Location 和 Linked Attachment Base Directory。尤其是链接附件,路径在 Windows、macOS、Linux 之间通常不同。
- 引用样式:进入
Settings → Cite检查常用样式;不要假定自定义样式和所有偏好都已按预期恢复。 - 插件:第三方插件不要只从旧电脑复制文件夹后直接使用。Zotero 官方提醒插件拥有访问 Zotero 和电脑的权限,应从可信开发者处重新核对兼容性并安装。插件说明
- Word 或 LibreOffice 插件:新电脑首次启动 Zotero 后通常会自动安装;如果文字处理器中没有 Zotero 工具栏,进入
Cite → Word Processors重新安装,并重启 Word 或 LibreOffice。文字处理器插件安装说明
迁移后的 Word 检查应包括:打开一份已有文档,确认 Zotero 插件已启用;新建一个空文档测试插入引用;再打开旧文档刷新一次。不要只看文档里是否显示文字,因为插件未安装、文档权限受限或引用字段异常时,表面文本仍可能存在。
迁移完成后的核对清单与失败回退
- 条目总量与旧电脑大致一致,重点检查最近新增的文献。
- 收藏夹层级、标签、检索条件和独立笔记仍然存在。
- 随机离线打开本地 PDF、网页快照和其他存储附件。
- 打开几份带高亮、批注或 PDF 笔记的文件,确认注释仍可见。
- 检查链接附件;如果出现“文件不存在”,不要反复导入同一 PDF,先使用 Locate 或修正链接附件基目录。
- 检查同步面板,确认没有异常的大量删除、重复条目或冲突提示。
- 在 Word 或 LibreOffice 中测试新引用、既有引用刷新和参考文献生成。
- 至少保留旧电脑、
Zotero-Old文件夹或完整备份一段时间。
失败回退顺序:先退出 Zotero;保留当前新电脑目录副本;恢复旧目录或备份目录;暂时关闭自动同步;确认本地结果后再决定是否同步。若怀疑数据库损坏,不要把任意 .sqlite 文件通过导入功能加载,优先使用官方备份恢复流程或数据库修复工具。Zotero 数据库损坏排查
如果新电脑同步、附件访问或 WebDAV 验证持续异常,可在确认账户、域名和服务条款无误后,再使用边界云加速的网络排查服务定位连接问题;它不是 Zotero 官方迁移方案,也不能替代数据备份。
常见问题 FAQ
Zotero 数据库迁移必须复制哪些文件?
整库迁移建议复制整个数据目录,而不是只复制 zotero.sqlite。数据库主要保存条目、笔记和标签,storage 通常保存本地附件;复制前应关闭 Zotero,不要自行挑选或删除数据库临时文件。
换电脑后有条目但没有 PDF,应该怎么办?
先判断 PDF 是存储附件、Zotero Storage、WebDAV 还是链接附件。存储附件检查 storage 是否完整;同步迁移检查文件同步和下载方式;链接附件检查原文件路径或 Linked Attachment Base Directory。未下载到旧电脑本地的附件不能作为本地备份。
可以把 Zotero 数据库放进 OneDrive 或 Dropbox 吗?
不建议。官方文档指出,云盘同步文件夹中的活动数据目录很容易产生数据库损坏或冲突副本。可以在 Zotero 完全关闭后把数据目录复制到外部位置作为临时备份,但不要让多个设备直接同时读写它。
WebDAV 会自动迁移条目和 PDF 吗?
不会。WebDAV用于个人库的附件文件同步,条目、笔记、标签和收藏夹仍依赖 Zotero 数据同步。新电脑要登录同一账户,并重新检查 WebDAV 地址、账户信息和 Verify Server 结果。
完整复制数据目录后,插件和 Word 引用插件会自动可用吗?
不能保证。新电脑需要重新核对第三方插件、引用样式和 Word 或 LibreOffice 插件。文字处理器插件通常随 Zotero 安装,但如果工具栏没有出现,应在 Cite → Word Processors 中重新安装并重启文字处理器。
新电脑打开 Zotero 后显示空库,先做什么?
先退出 Zotero,不要立即同步或导入。通过 Advanced → Files and Folders → Show Data Directory 核对当前路径,确认复制的是完整数据目录而不是单个文件或嵌套目录;替换前保留现有空库副本。
恢复备份后可以马上开启自动同步吗?
不建议马上开启。先检查本地恢复结果;如果在线库中存在更近的删除或修改,重新同步可能把这些变化应用到恢复后的数据库。确认版本取舍后,再手动同步并观察冲突提示。
常见问题
Zotero 数据库迁移必须复制哪些文件?
整库迁移建议复制整个数据目录,而不是只复制 zotero.sqlite。数据库主要保存条目、笔记和标签,storage 通常保存本地附件;复制前应关闭 Zotero。
换电脑后有条目但没有 PDF,应该怎么办?
先区分存储附件、Zotero Storage、WebDAV和链接附件,再分别检查 storage、文件同步设置、WebDAV验证结果或原文件路径。
可以把 Zotero 数据库放进 OneDrive 或 Dropbox 吗?
不建议。活动数据目录放在实时云盘同步文件夹中可能导致数据库损坏。关闭 Zotero 后复制数据目录作为临时备份,与直接让云盘托管活动数据库不是一回事。
WebDAV 会自动迁移条目和 PDF 吗?
不会。WebDAV主要用于个人库附件文件同步,条目、笔记、标签和收藏夹仍依赖 Zotero 数据同步。
完整复制数据目录后,插件和 Word 引用插件会自动可用吗?
不能保证。新电脑需要重新核对第三方插件、引用样式和文字处理器插件;工具栏缺失时,从 Cite → Word Processors 重新安装。
新电脑打开 Zotero 后显示空库,先做什么?
先退出 Zotero,不要立即同步或导入;核对 Show Data Directory 显示的路径和复制层级,并保留现有空库副本后再替换。
恢复备份后可以马上开启自动同步吗?
不建议。先确认本地恢复版本,再决定是否同步,因为在线库中的较新删除或修改可能覆盖恢复后的本地结果。
相关阅读
参考资料
- The Zotero Data Directory — Zotero Documentation
- How can I move my Zotero library to a different computer? — Zotero Documentation
- Syncing — Zotero Documentation
- Sync Preferences — Zotero Documentation
- Zotero Settings — Zotero Documentation
- Advanced Settings — Zotero Documentation
- Adding Files to Your Zotero Library — Zotero Documentation
- Installing the Zotero Word Processor Plugins — Zotero Documentation
- Plugins for Zotero — Zotero Documentation
- What do I do if my Zotero database is corrupted? — Zotero Documentation