重装系统、换电脑、把旧版本连程序带数据一起删干净，然后又得把几百上千条文献和附件原样搬回来——这几个场景只要沾上一个，Search 里那堆"Zotero 怎么迁移"的答案就会开始互相打架：有说直接登录账号同步的，有说复制某个文件夹就行的，还有人抄了半截教程把zotero.sqlite单独挪走，结果附件全军覆没。我前后折腾过不少次，踩坑踩得比较彻底，今天就把这套Zotero 文献库手动无损迁移的完整流程摊开讲：什么叫"无损"、数据到底散落在几个目录里、哪些能靠同步兜底哪些必须动手拷贝、以及删除旧版本之前那一步为什么最关键。适合刚入门、正准备重装系统的人，也适合用了一两年、库里已经攒了几百条带 PDF 附件的老用户——只要跟着走一遍，基本不会丢数据。
1. 先想清楚：为什么这件事不能只靠"同步"
很多人第一反应是打开 Zotero 的同步功能，觉得登录账号、等进度条走完，换台电脑再登一次就完事了。这套逻辑在理想情况下确实成立，但它有几个隐藏前提，一旦不满足就会翻车。我见过最常见的误解是"同步等于备份"，其实两者是两回事：同步是为了让多台设备看到同一份库，备份是为了在数据出问题时能还原，前者是持续状态，后者是某一时刻的快照。你要做迁移，本质上需要的是一个能独立还原的完整副本。
1.1 同步能带走什么，带不走什么
Zotero 的在线同步会把条目元数据、笔记、标签、集合结构这些都传上去，附件在满足条件时也能同步（前提是你的存储配额够用，且附件是"存储附件"而不是"链接附件"）。但它带不走的东西同样明确：一是本地配置，包括你自定义的引用样式路径、快捷键、界面偏好；二是插件本身和插件产生的数据，比如常用的一些文献管理增强插件、引文工具类插件；三是"链接附件"——这类附件在数据库里只记录了一个指向本地磁盘的绝对路径，同步根本不知道该传什么。
我见过太多人迁移完发现 PDF 打不开，点开一看是链接附件，原文件还躺在旧电脑的某个文件夹里。所以如果你库里存在链接附件，同步这条路的坑就会在迁移后才暴露。这也是为什么我更倾向手动拷贝数据目录：它把"能带走的"和"需要单独处理的"一次性摆在你面前，不会给你虚假的安全感。
1.2 什么情况下必须手动迁移
按我自己的经验，下面几种情况基本堵死了纯同步的路子。第一种是重装系统或者换电脑，旧机器的硬盘可能直接格式化，你没有机会再打开 Zotero 去触发一次完整同步，只能提前把数据目录整体备份出来。第二种是彻底删除旧版本，很多人的删除操作是"卸载程序 + 顺手删掉用户目录"，结果zotero.sqlite和storage一起没了，这时候唯一的救命稻草就是之前的手动备份。第三种是断网或者配额受限的环境，附件动辄几个 G，靠上传下载等不起。
还有一个容易被忽略的点：手动迁移其实是理解整个库结构的过程，一旦你搞清楚数据分布，以后做定期备份、排查附件丢失、迁移到新硬盘都会变得很轻松。与其每次出事都临时搜教程，不如把这一套流程吃透。
1.3 "无损"到底指什么
我把"无损"拆成三层来定义。第一层是条目层面，所有文献的题录信息、作者、期刊、年份、笔记、标签、关联关系一字不差地回来；第二层是附件层面，PDF、网页快照、补充材料这些文件本体能正常打开，而不是变成一个指向空气的链接；第三层是使用层面，插件配置、自定义样式、界面偏好这些让你"用着顺手"的东西尽量保留。前两层是硬指标，第三层能做到最好，做不到也不影响文献本身。
后面所有操作都是围绕这三层来设计的，你读的时候可以对照着判断每一步在保护哪一层。
2. 迁移前，先把三个目录分清楚
这是整套流程里最关键的一节。Zotero 的数据不是一个文件夹，而是分散在几个位置，很多人迁移失败就是因为只搬了一部分。我把它拆成三个概念：数据目录、程序目录、配置目录。程序目录是安装路径，卸载重装自然会换，跟你的文献没关系；真正要搬的是数据目录和配置目录，而这两者常常不在同一个地方。
2.1 数据目录：文献和附件的真正大本营
数据目录是 Zotero 存放zotero.sqlite和storage文件夹的地方，默认位置各系统不一样，我整理成一张表方便对照：
| 操作系统 | 默认数据目录位置 |
|---|---|
| Windows | C:\Users\你的用户名\Zotero |
| macOS | /Users/你的用户名/Zotero |
| Linux | ~/Zotero |
这个目录里有几个东西必须认识。zotero.sqlite是整个库的核心数据库，条目、集合、标签全在里面；storage是一个个以条目键命名的子文件夹，每个子文件夹里放着对应条目的附件文件；此外还可能看到styles（自定义引用样式）、translators（网页抓取规则）等子目录。迁移时这几样要作为一个整体搬走，不能拆。
提示：
zotero.sqlite和storage必须一起拷贝，且保持相对位置不变。数据库里记录的附件路径是相对于storage的，单独把 storage 挪到别处，数据库就找不到文件了。
2.2 配置目录：偏好设置和插件的藏身处
配置目录在另一条路径上，它存的是prefs.js（各种偏好设置）和extensions（已安装的插件）。默认位置大致是：
| 操作系统 | 默认配置目录位置 |
|---|---|
| Windows | C:\Users\你的用户名\AppData\Roaming\Zotero\Zotero\Profiles\随机名.default |
| macOS | /Users/你的用户名/Library/Application Support/Zotero/Profiles/随机名.default |
| Linux | ~/.zotero/zotero/随机名.default |
AppData和Library在文件管理器里默认是隐藏的，Windows 需要勾选"显示隐藏项目"，macOS 可以用快捷键Cmd + Shift + G直接输入路径跳转。配置目录里最值钱的是prefs.js，注意它是纯文本，里面有extensions.zotero.dataDir这一项，记录着数据目录的实际路径。如果你把整个配置目录原样搬到新机器，这条路径可能还指向旧位置，导致 Zotero 打开后显示的是一个空库——这是新手最容易撞的坑。
2.3 为什么一定要分清这两者
数据目录决定了"你的文献在不在"，配置目录决定了"你的 Zotero 顺不顺手"。很多人迁移时只搬了数据目录，结果是库回来了，但之前调好的引用格式、快捷键全没了，插件也得重装。反过来，只搬配置目录更危险，因为prefs.js里那条路径会指向不存在的旧目录，Zotero 启动时可能静默创建一个新的空库，你一看以为数据丢了，实际是被藏起来了。
我通常的做法是：先搬数据目录（保命），再按需搬配置（保顺手）。两者分开处理，出问题也好定位。
3. 核心实操：备份与还原的完整步骤
接下来是动手环节，我把整个过程按时间顺序拆成四步，每一步都写上操作意图和验证方法，方便你对照执行。
3.1 第一步：彻底关闭 Zotero，别省这几十秒
迁移前必须完全退出 Zotero，包括托盘图标和后台进程。这不是多此一举：Zotero 使用的数据库在运行时会开启日志模式，除了zotero.sqlite之外，同目录下可能还有zotero.sqlite-wal和zotero.sqlite-shm两个文件，它们是尚未合并进主数据库的增量数据。如果你在程序运行时直接复制zotero.sqlite，就等于只拷走了旧快照，最近这几天的改动会全部丢失。
正确做法是关掉主窗口后，再检查一下任务管理器（Windows）或活动监视器（macOS）里有没有残留的相关进程，有就强制结束。退出后再看数据目录，通常会看到zotero.sqlite旁边还有一个zotero.sqlite.bak，这是软件自动生成的备份副本，迁移时可以一并带走作为兜底。
注意：不要在 Zotero 运行状态下复制数据库。开机自启或者后台驻留的情况很常见，关窗口不等于关程序。
3.2 第二步：整体复制数据目录到安全位置
确认进程清干净后，把整个数据目录复制到一块与你当前系统盘不同的物理磁盘上，比如移动硬盘或者另一块本地分区。为什么要强调物理隔离？因为重装系统很可能伴随格式化 C 盘，备份放同一个盘等于没备份。复制的时候直接对整个文件夹做"复制-粘贴"，不要进到 storage 里逐个挑文件。
复制完成后做一次核对：进入数据目录，看storage文件夹里的子文件夹数量是否与你印象中的条目数大致匹配；再打开zotero.sqlite所在位置，确认文件大小不是 0 字节。我通常会顺手记一笔备份的时间点和文件总大小，还原时拿来比对，省得事后怀疑是不是漏了。
3.3 第三步：新环境安装后，指定数据目录位置
新系统装好 Zotero 后，先不要急着往里导入任何东西。打开设置，找到"高级"里的文件与文件夹选项，把数据目录位置改成你复制过来的那个文件夹。这里有两种做法：一种是把备份直接放到新的默认数据目录位置（比如新系统的~/Zotero），让软件自动读取；另一种是保持备份在移动硬盘上，通过设置里"自定义"的方式指向它，适合临时使用。
我一般推荐第一种，因为默认位置最稳，软件更新、插件读取都不会因为外部磁盘掉线而出问题。指向完成后重启 Zotero，左侧集合列表应该能完整加载出来，随便点开一条文献，看右侧附件面板里的 PDF 是否能正常预览。
3.4 第四步：逐项验证，别只看首页
验证环节最容易被跳过，但恰恰是它决定了你这次迁移到底算不算"无损"。我按重要性列一个检查清单：
| 检查项 | 验证方法 | 预期结果 |
|---|---|---|
| 条目数量 | 对比迁移前后左侧"我的文库"计数 | 数量一致 |
| 集合结构 | 看左侧树状结构是否完整 | 层级不缺失 |
| 存储附件 | 随机打开几条文献的 PDF | 能正常显示 |
| 笔记与标签 | 打开带笔记的条目 | 内容完整 |
| 链接附件 | 打开显示为链接的文件 | 可能需要重新关联 |
| 插件状态 | 看插件是否被识别 | 重新配置或启用 |
前五项里，前四项是硬指标，必须全绿；链接附件大概率要手动重新关联，这是预期之内的；插件状态取决于你有没有搬配置目录。验证时不要只翻第一页的几条文献，最好随机抽不同集合、不同年份的条目，因为附件缺失往往集中在某些批量导入的批次里。
4. 三种典型场景，处理方式不一样
同样是迁移，重装系统、彻底删除旧版本、升级版本这三种情境的细节差别不小，分开讲更清楚。
4.1 重装系统与换电脑
这是最标准的场景，核心是"先备份再动手"。旧系统能正常开机时，进 Zotero 确认数据目录位置（有些人改过默认路径，别想当然），关程序，整体复制到移动硬盘，然后才去重装。新系统装好后再按第 3 步还原。这里有个小细节：如果你旧系统里的数据目录被改到过 D 盘或者用户目录之外的地方，重装时那部分可能压根没被格式化，直接指过去就能用，省去一次拷贝。
换电脑还需要注意权限问题。从旧机器拷过来的文件夹，有时会因为用户账户不同导致读写受限，Windows 上表现为能打开但不能保存，macOS 上可能提示没有权限。解决办法是复制完成后，对文件夹做一次"属性里的解除锁定"或者重新设置所有者，具体在系统文件属性里操作即可。
4.2 彻底删除旧版本之后
这个场景最被动，因为前提是你已经删了。这时候能不能救回来，取决于删除时有没有连数据目录一起删。如果只是卸载了程序，~/Zotero还在，那恭喜你，重装后默认就会读到它；如果你顺手把用户目录也清了，那就只能靠之前的备份。这也是我在第 3 节强调备份要放独立磁盘的原因——删除操作发生的那一刻，备份是你唯一的退路。
如果既没备份又删干净了，还能尝试的方向是从系统回收站/废纸篓里找zotero.sqlite和storage，或者看有没有云盘自动同步过那个目录。但这些都属于撞运气，不是可复现的方法，所以我的建议始终是：删之前先备份。
4.3 安装新版本升级
升级版本和迁移不完全是一回事，但经常被混着问。正常的小版本升级不需要迁移，软件会沿用现有的数据目录结构。真正需要注意的是跨大版本升级时，数据库结构可能发生变化，升级后会被自动转换，转换之后旧版本的软件可能就无法再读取这个库了。
所以我养成的习惯是：升级大版本之前，先把数据目录整体复制一份留作快照，再执行升级。万一升级后发现某些插件不兼容、或者某个附件打不开，还能退回去排查。升级本身不应该动数据目录的位置，但如果你之前手动改过路径，升级后要复查一下设置里的路径是否还在。
5. 高频翻车点与排查实录
这一节是我这些年踩过和帮别人排查过的坑，按出现频率排。
5.1 附件全变成"找不到文件"
最常见的报错。原因基本只有两个：一是只拷了zotero.sqlite没拷storage，二是拷了 storage 但放错了层级。数据库里附件记录的是相对路径，Zotero 会去数据目录下找storage/条目键/文件名，层级错一位就找不到。排查方法很简单：随便点一条报错的文献，看它对应的 storage 子文件夹是否真实存在，再对比文件名是否一致。
5.2 启动后显示空库
这个我在 2.2 节提过，多半是配置目录里的prefs.js指向了旧路径。解决方式是进设置手动把数据目录改到正确位置，或者直接删掉配置文件让软件重建（代价是偏好设置丢失）。判断依据是：设置里显示的数据目录路径，是不是你实际存放数据的路径。
5.3 链接附件路径断裂
链接附件存的是绝对路径，换电脑后盘符或者用户目录变了，链接自然断。这类附件没法通过拷贝自动修复，需要在附件上右键重新定位，或者借助插件做批量重关联。如果你的库里链接附件很多，迁移前最好先把它们转成存储附件，能省掉大量手工操作。
5.4 数据库损坏或版本不兼容
偶尔会遇到软件提示数据库无法打开。先看是不是把zotero.sqlite单独拿出来用了，缺了配套文件就会这样。另一种情况是升级后降级，数据库已经被新版本转换过，旧版本读不了。预防办法就是升级前留快照，出问题时用快照回退。
5.5 插件不工作
插件本体和配置分散在两处，只搬数据目录不带配置，插件就会处于未安装或未配置状态。重新安装并配置一遍通常能解决。需要注意的是，个别插件的数据也存在数据目录里，迁移时要一并带走。
6. 把迁移变成常规操作的一些习惯
最后分享几个我长期用下来觉得省心的习惯。第一，把"关程序、整体复制、放独立磁盘"当成一个固定动作，每次大改动前做一遍，成本很低。第二，数据目录尽量别放在系统盘，单独划一个分区放文献，重装系统时它不受影响。第三，链接附件能用存储附件就用存储附件，长期看它能让你在任何机器上打开库都是完整的。第四，定期抽查几条带附件的文献能不能打开，比等到迁移后才发现问题要早得多。
我个人在实际操作中的体会是：迁移这件事本身不难，难的是在动手之前把"数据在哪、配置在哪、备份放哪"这三个问题回答清楚。搞清楚结构之后，剩下的就是复制粘贴和验证，没什么玄学。真正会让人手忙脚乱的，永远是那个没提前做备份、然后一删了之的下午。
