重装系统前那晚，我把 Zotero 从 C 盘整个拷到移动硬盘，自以为万事大吉。结果新系统装好、软件重装、文件夹拖回去，一打开——条目在，附件全是红色的"找不到文件"。后来才知道，我复制的时候 Zotero 还在后台跑着，数据库处于 WAL 模式，拷出来的是个半成品快照。这件事之后我把 Zotero 文献库手动无损迁移这套流程反复打磨了几遍，覆盖重装系统、彻底卸载旧版、同机升级、换电脑四种情况，每一条路径都实际跑过。这篇就把数据目录结构、停写时机、搬迁顺序、迁移后的对账方法一次讲透，适合任何不想把几年积累的文献和批注赌在"应该没事吧"上的人。

1. 先搞清楚 Zotero 把东西藏在哪三个地方

很多人迁移失败的根源，不是操作不熟练，而是从一开始就没弄清楚"文献库"到底由哪几块组成。Zotero 不像某些软件把所有东西塞进一个安装目录，它把数据、配置、程序本体分得很开，而且默认分散在系统不同位置。你只搬其中一块，剩下的就会变成孤儿数据，界面上看着像是丢了，其实只是没接上。

1.1 数据目录：条目、附件和笔记的真正老家

数据目录是整个迁移的核心，默认位置在用户主目录下，文件夹名就叫Zotero。Windows 上是C:\Users\<用户名>\Zotero，macOS 是/Users/<用户名>/Zotero，Linux 是/home/<用户名>/Zotero。这个目录里最关键的几样东西：zotero.sqlite是主数据库，存着所有条目的元数据、集合结构、标签、笔记正文、附件记录；storage文件夹是附件实体仓库，每个附件对应一个以 8 位字符命名的子文件夹，里面躺着 PDF、网页快照、补充材料；此外还有styles（CSL 引文样式）、translators（网页抓取规则）、logs（日志）等辅助目录。

这里要特别提醒一句：storage的文件夹名不是父条目的 key，而是附件本身的 item key。所以一个条目挂了三个 PDF，storage下就会有三个独立文件夹。这个细节决定了你后面做数量对账时，不能拿条目数去跟文件夹数直接比，否则会得出"附件丢了一大半"的错误结论。

除了上面这些，数据目录里通常还会看到zotero.sqlite.bak、zotero.sqlite-wal、zotero.sqlite-shm这几个文件。.bak是上一次成功启动时留下的备份，.wal和.shm是 SQLite 的预写日志和共享内存文件。这三个文件是后面"停写"环节的关键，先记住它们的存在。

1.2 配置目录：插件、偏好和同步凭据的落脚点

配置目录存放的是"软件怎么用"的信息，而不是"文献是什么"的信息。它藏在系统的应用数据区：Windows 在C:\Users\<用户名>\AppData\Roaming\Zotero\Zotero\Profiles\<随机串>.default，macOS 在/Users/<用户名>/Library/Application Support/Zotero/Profiles/<随机串>.default，Linux 在/home/<用户名>/.zotero/zotero/<随机串>.default。注意 Windows 上AppData是隐藏目录，资源管理器默认不显示，很多人第一次找会以为不存在。

这个目录里最值钱的是prefs.js，它记录了界面布局、抓取偏好、数据目录的自定义路径（extensions.zotero.dataDir）、链接附件基目录（extensions.zotero.baseAttachmentPath）、同步账号等。extensions子目录里是已安装的插件。也就是说，如果你希望新环境里插件还在、设置不重置，配置目录也得一起搬；如果你只关心文献本身，配置目录可以不动，让新环境生成一份干净的。

我的建议是：数据目录必搬，配置目录选搬。插件装得多、快捷键和界面调教过的，一起搬省事；插件少、想借机清理的，只搬数据目录，重装插件反而更干净。

1.3 两个目录的默认路径对照表

不同系统下这两个目录的位置差异不小，尤其是 macOS 的配置目录藏在资源库深处。下面这张表建议直接收藏，迁移前照着找一遍，避免在文件管理器里瞎翻。

如果你之前改过数据目录（比如挪到 D 盘），最准确的确认方式是打开 Zotero，进"设置 → 高级 → 文件和文件夹"，看"数据目录位置"那一行显示的实际路径。以软件显示的为准，别以记忆为准，这是我在一次"明明改过却找不到"的折腾之后定下的规矩。

2. 为什么"直接拖文件夹"经常翻车

网上流传最广的做法是：找到Zotero文件夹，复制，粘贴到新机器，完事。这个方法在理想状态下确实能成，但它对时机、完整性、版本三个条件同时成立有要求，任何一个不满足就会出问题。下面这三种翻车方式，我几乎每一种都亲手经历过或者帮人收拾过残局。

2.1 运行中复制数据库：拿到的是半成品

SQLite 默认在 WAL 模式下工作，写操作先落到-wal文件，再择机合并回主库。这意味着 Zotero 开着的时候，zotero.sqlite本身可能并不是最新状态，最新的改动还在-wal里。你此时只复制zotero.sqlite而漏掉-wal和-shm，得到的库会缺最后一段时间内的所有改动，严重的还会因为日志链断裂而打不开。

更隐蔽的情况是：你复制的时候 Zotero 恰好正在写，复制到一半的文件在字节层面就是不完整的。这种库用 SQLite 打开会直接报database disk image is malformed。所以迁移的第一条铁律不是"复制"，而是先让 Zotero 彻底停下来。

Windows 上尤其要注意，点了关闭按钮不代表进程真的退了。Zotero 有时会在后台留一个进程处理同步或索引，任务管理器里能看到zotero.exe还挂着。我的做法是关掉窗口后打开任务管理器，确认没有 Zotero 相关进程，再等三五秒，让磁盘写入落定，然后才开始复制。macOS 和 Linux 相对好判断，ps aux | grep -i zotero看一眼就行。

2.2 只搬 storage 或只搬 sqlite：一半数据变孤儿

第二种高频错误是只搬一半。有人觉得数据库是"核心"，只拷zotero.sqlite，结果新环境里条目列表完整，点开任何一个附件都提示找不到文件；也有人反过来，把storage整个拷过去，数据库却是新的空库，那一堆文件夹在 Zotero 眼里就是无主文件，界面上完全看不见。

这两者的关系可以类比成图书馆的目录卡片和书库：目录卡片告诉你有什么书、放在哪个架位，书库放着实体书。只搬目录，你查得到借不到；只搬书库，你连有什么书都不知道。zotero.sqlite里itemAttachments表的path字段记录着每个附件指向storage下哪个文件夹，两边必须成对出现。

所以正确的搬运单位是整个数据目录，而不是目录里的某个文件。这一条没有例外。

2.3 版本降级这道坎：数据库升上去就下不来

这是最容易被忽略、后果又最麻烦的一条。Zotero 每次大版本升级都会顺带升级数据库结构。用新版打开过的库，再用旧版打开，旧版会直接拒绝，提示数据库版本过高、无法使用。而且这个升级是单向的，没有官方回退工具。

我见过不止一个人踩这个坑：新电脑上装了最新版，把旧电脑的库拷过来打开，一切正常；后来因为某个插件不兼容，想退回旧版，发现库已经打不开了，只能从更早的备份恢复。所以迁移之前，先记下源机器的 Zotero 版本号（帮助 → 关于），新机器上装的版本要么相同，要么更高。如果一定要用旧版，就得在旧版打开之前先把库恢复成升级前的备份状态。

顺带说一句，zotero.sqlite.bak这个文件在这里能救命。它是上一次成功启动时的快照，如果新版刚打开就把库升级了、你又后悔了，把.bak改名成zotero.sqlite覆盖回去，通常能退回升级前的状态。前提是你没有再启动过第二次——第二次启动会把.bak也刷新成新版格式。

3. 手动无损迁移的完整操作链路

把原理讲清楚之后，具体操作其实不复杂，但顺序不能乱。我把它拆成四步：停写、打包、落地、核对。每一步都有明确的完成标志，做完一步再进下一步，出问题也好定位是哪一环。

3.1 第一步：停写与快照，把数据库"冻住"

这一步是整个流程里最不能省的一步。具体做法：关闭 Zotero 所有窗口，托盘图标也要退出（Windows 右下角、macOS 菜单栏），然后用任务管理器或ps确认进程已消失。接着等十几秒，让操作系统把缓存刷到磁盘。

如果你想要更稳妥，可以在关闭前先做一次主动整理：进"设置 → 高级 → 文件和文件夹"，点一下"检查数据库完整性"。这个功能底层跑的是 SQLite 的完整性检查和外键检查，能提前发现库里已有的损坏，避免你带着一个坏库迁移，到新环境才暴露问题。跑完正常的话，再关软件。

关掉之后，建议把整个数据目录复制一份到临时位置，作为"快照"。复制的时候用系统的复制粘贴就行，不要用剪切，也不要在原目录里做任何改动。这一步的完成标志是：临时位置的副本大小与原目录一致，storage下的文件夹数量对得上。

注意：如果你的数据目录在机械硬盘上、体积又比较大（几十 GB 很常见），复制过程可能要好几分钟。这期间别去动原目录，也别启动 Zotero。

3.2 第二步：打包数据目录，别漏掉隐藏文件

复制到移动硬盘或者新机器时，有两个细节容易漏。第一是隐藏文件，.bak、-wal、-shm在部分系统视图下不显示，用图形界面拖拽可能漏掉。稳妥的做法是用压缩包：把整个Zotero文件夹打成 zip 或 7z，压缩过程会包含所有文件，不受视图设置影响，顺便还能校验完整性。第二是文件系统限制，如果目标盘是 FAT32，单个文件不能超过 4GB，而zotero.sqlite在文献量大、笔记多的情况下完全可能超过这个体积，复制会中途失败。exFAT 或 NTFS 没有这个问题。

打包完成之后，我的习惯是在压缩包旁边放一个文本文件，写上三行信息：源机器的 Zotero 版本号、数据目录的绝对路径、打包时的条目总数。这三行在后面的核对环节能省很多事，尤其是同时维护多个库的时候。

3.3 第三步：新环境落地与数据目录重定向

新机器上的顺序很关键：先装 Zotero，但先不要急着往里导数据。装完之后启动一次，让它生成默认的数据目录和配置目录，然后关闭。这一步的意义是让软件把运行环境准备好，避免你手工造目录时漏掉某些结构。

接下来把压缩包里的Zotero文件夹解压出来，放到目标位置。如果你想让它回到默认路径，就直接覆盖新生成的同名目录；如果你想放在 D 盘或外置盘，有两种做法。

第一种是用启动参数指定数据目录，这也是最干净的方式。Windows 下可以建一个快捷方式，目标写成"C:\Program Files\Zotero\zotero.exe" -datadir "D:\ZoteroData"；macOS 下在终端里执行/Applications/Zotero.app/Contents/MacOS/zotero -datadir /Volumes/Data/ZoteroData。用这个参数启动，Zotero 会直接认这个目录，不碰默认位置。

第二种是在软件里改：启动后进"设置 → 高级 → 文件和文件夹 → 自定义"，选到你的目录，重启生效。这个方式的好处是不用记命令行，缺点是第一次启动时用的还是默认空库，改完重启才切过去，中间容易让人误以为数据没迁成功。

还有一种偏极客的做法是用目录链接，Windows 下mklink /J "C:\Users\<用户名>\Zotero" "D:\ZoteroData"，macOS/Linux 用ln -s。这样软件以为自己在读默认路径，实际指向另一块盘。适合系统盘小、想把数据放大的场景，但要注意备份工具可能会跟着链接跑偏，得心里有数。

3.4 第四步：首次启动后的核对清单

数据落地、软件启动之后，别急着关，按下面这份清单过一遍。这份清单是我在几次迁移之后固定下来的，每次照着走，五分钟内能确认迁移是否真的无损。

表格里"条目总数"这一项，如果你的库比较大，界面计数可能要等几秒才刷新出来，别急着下结论。附件抽查建议覆盖不同类型：导入的 PDF、网页快照、链接的外部文件，三类都抽到，才能确认storage和链接路径两条链路都通。

4. 四种典型场景的差异化处理

同样是迁移，触发原因不同，风险点也不一样。重装系统怕的是没备份全，彻底卸载后重装怕的是残留干扰，同机升级怕的是版本回退，换电脑怕的是路径和权限。分开说清楚，比一套流程硬套四种情况靠谱得多。

4.1 重装系统：备份盘里的那份拷贝怎么用

重装系统是四种场景里风险最高的，因为 C 盘会被格式化，数据目录一旦没提前拿出来就彻底没了。这里有个很多人不知道的事实：卸载 Zotero 程序不会删除数据目录，但重装系统会。所以重装前的动作必须是主动备份，而不是指望卸载时留下什么。

备份的时机要在重装前至少一天，别等到最后一刻。原因是重装前那段时间你往往还在用 Zotero 补文献、改笔记，备份太早会丢最后一天的改动，备份太晚又容易手忙脚乱漏文件。我的做法是重装前一天晚上完整备份一次，重装当天早上再增量同步一次storage和zotero.sqlite，两次都有，心里踏实。

重装完成后，先装 Zotero，再恢复数据。这里有个顺序上的坑：如果你在装软件之前就把Zotero文件夹放到用户目录下，某些安装程序检测到已有数据目录，可能会跳过初始化，导致配置目录缺东西。所以按"先装、启动一次、关闭、再覆盖数据"的顺序来，最稳。

4.2 彻底删除旧版本后重装：残留与注册表之外要注意的

"彻底删除"这个动作，不同人理解不一样。有的人只是走了卸载程序，有的人连数据目录、配置目录一起手动删了。这两种情况下恢复策略完全不同。

如果只是卸载程序、数据目录还在，那最简单：重装同版本或更高版本，启动后数据自动就在，因为默认路径没变。这种情况几乎不需要迁移操作，唯一要检查的是配置目录有没有被卸载程序清掉，插件可能需要重装。

如果连数据目录都删了，那就只能靠外部备份或者 Zotero 官方同步恢复。这里要提醒一句：官方同步同步的是元数据和附件，但如果你之前用的是本地存储模式且没开文件同步，附件可能只在本地有一份，删了就真没了。所以"彻底删除"之前，务必确认备份存在，或者确认同步状态是完整的。

还有一种半吊子情况：卸载后重装，发现 Zotero 打开是空库，但硬盘上明明有Zotero文件夹。这通常是因为新版本的数据目录路径变了，或者你之前改过自定义路径而配置目录被清了。进设置里看一眼"数据目录位置"，手动指回去即可。

4.3 同机升级到新版：其实最省事但也最容易大意

同机升级是四种场景里最简单的，因为数据目录原地不动，装完新版直接打开就行。但简单不等于没风险，最大的风险是升级不可逆。新版第一次打开时会升级数据库结构，升级之后旧版就打不开了。如果你升级后才发现某个关键插件不兼容，想退回去，就得靠升级前的备份。

所以我的习惯是：升级前手动复制一份数据目录，命名成Zotero_backup_升级前日期，放在旁边。这个备份不占太多空间（如果你文献不多），但能在关键时刻救你一命。升级完成后先别删，用上一周确认没问题再清理。

另一个容易被忽略的点是插件兼容性。大版本升级时，部分插件会失效或者需要更新版本。升级后进"工具 → 插件"看一眼，有更新的就更新，不兼容的先禁用，别让一个插件把整个软件拖崩。

4.4 换电脑：跨系统迁移的路径与权限问题

换电脑分两种情况：同系统换机、跨系统换机。同系统基本就是把数据目录搬过去，路径结构一致，最省心。跨系统就麻烦一些，主要是三件事：路径分隔符、文件名大小写、文件权限。

路径分隔符的问题主要影响链接附件。如果你用的是"链接文件"模式而不是"导入文件"模式，itemAttachments.path里存的是文件路径，Windows 上是D:\文献\xxx.pdf这种反斜杠格式，搬到 macOS 或 Linux 上就失效了。解决办法是迁移后在设置里重新指定"链接附件基目录"，并尽量使用相对路径模式，让 Zotero 自己拼接。

文件名大小写的问题出现在 Windows 迁到 Linux 的场景。Windows 文件系统不区分大小写，Linux 区分。如果storage里存在只差大小写的两个文件夹，Linux 上复制时会被合并或者冲突。这种情况少见但确实存在，迁移前可以先在源机器上扫一遍。

文件权限的问题在 Linux 上比较明显。从移动硬盘拷过来的文件，属主可能是 root 或者带上了 U 盘的权限位，导致 Zotero 读不了。迁移后执行一次chown -R <用户名>:<用户名> ~/Zotero和chmod -R u+rw ~/Zotero，基本能解决。

5. 迁移后高频故障的排查顺序

迁移完打开软件，最怕看到红色报错或者一堆"找不到文件"。这类问题的排查有固定顺序，从最常见、最好修的往下走，别一上来就怀疑数据库损坏。

5.1 附件显示"找不到文件"的三类原因

第一类，storage没搬全。这是最常见的，尤其是用图形界面拖拽、漏掉隐藏文件或者复制中途中断的情况。排查方法：进数据目录，数一下storage下的文件夹数量，再跟数据库里导入型附件的数量对比，差得多就是没搬全。

第二类，链接附件路径失效。如果你用的是链接模式，附件实体根本不在storage里，而在你指定的某个文件夹。换电脑后那个文件夹路径变了，Zotero 自然找不到。修复方式是进设置里的"链接附件"部分，重新指定基目录，然后对受影响的条目右键"重新链接"。

第三类，文件名特殊字符。跨系统迁移时，某些在 Windows 上合法的字符在 macOS 或 Linux 上不合法，复制过程中被替换或截断，导致数据库里记的名字和实际文件名对不上。这种情况只能逐个修复，或者用 Zotero 自带的"查找可用文件"功能批量重连。

5.2 链接附件基目录失效的修复

链接附件这套机制值得单独说，因为它在迁移场景里出错率最高。Zotero 允许你把 PDF 放在自己的文件夹结构里，只在数据库里存一个指向它的路径，好处是文件组织自由、不占storage空间，坏处是路径一变就断链。

Zotero 较新的版本提供了"相对路径"选项，勾选之后，附件路径会相对于基目录存储，这样整个库连同附件文件夹一起搬走，路径关系不变，链接就不会断。这是我强烈建议开启的选项，尤其在你会换电脑、换盘符的情况下。

如果迁移后已经断了，修复步骤是：先把附件文件夹放到新位置，然后在 Zotero 设置里把"链接附件基目录"指到这个新位置，接着选中受影响的条目，右键选择重新链接附件，让软件按新基目录去匹配。批量操作时先拿一两个条目试，确认能匹配上再全选，避免把本来正常的条目也搞乱。

5.3 插件与样式失踪的处理

插件装在配置目录的extensions子目录里，如果你只搬了数据目录，插件自然不在。这不是故障，是预期行为，重新装一遍就行。要注意的是插件版本要和 Zotero 大版本匹配，旧版插件装到新版上可能直接不加载。

引文样式是另一回事。自定义的 CSL 文件放在数据目录的styles文件夹里，只要数据目录搬全了，样式就在。但如果你之前在软件里通过"从文件安装样式"装过，而源文件不在styles里，迁移后可能在样式列表里看不到。排查方式是进"设置 → 引用 → 样式"，看列表里有没有你想要的那几个，没有的话重新添加一次 CSL 文件即可。

5.4 数据库报错与完整性检查

如果启动时直接弹出数据库相关的错误，先别慌，按这个顺序来。第一步，确认zotero.sqlite和同目录下的-wal、-shm是不是一起搬过来的，缺了后两个的话，把源目录里的对应文件补上再试。第二步，把zotero.sqlite.bak复制一份改名成zotero.sqlite，看看能不能打开，这相当于回退到上一次成功启动的状态。第三步，进"设置 → 高级 → 文件和文件夹 → 检查数据库完整性"，让它跑一遍修复。

这三步都不行的话，说明库本身损坏比较严重，只能从更早的备份恢复，或者用 Zotero 的导出功能从还能打开的旧库里导出再导入。所以平时养成定期冷备份的习惯，比出事之后折腾强得多。

6. 怎么证明这次迁移是"无损"的

"看起来没问题"和"确认无损"是两回事。前者靠眼睛扫，后者靠数字对账。我每次迁移完都会做一轮对账，花不了几分钟，但能提前发现那些藏在深处的缺失。

6.1 用 SQL 做数量对账

Zotero 的数据库就是标准 SQLite，用任何 SQLite 客户端都能打开查。打开之前记得先关掉 Zotero，否则会锁库。下面几条查询能覆盖主要的数量核对。

-- 条目总数（排除回收站） SELECT COUNT(*) FROM items WHERE itemID NOT IN (SELECT itemID FROM deletedItems); -- 按附件类型统计 SELECT linkMode, COUNT(*) FROM itemAttachments GROUP BY linkMode; -- 笔记数量 SELECT COUNT(*) FROM itemNotes; -- 集合数量 SELECT COUNT(*) FROM collections; -- 标签数量 SELECT COUNT(*) FROM tags;

linkMode的取值含义：0 是导入文件（存在storage里），1 是导入的网页链接，2 是链接文件（存在外部路径），3 是链接的 URL。迁移前后各跑一次，把结果记下来对比。重点关注 0 这一类，它的数量应该和storage下的文件夹数量大致对应。

对应的storage文件夹计数，Windows 下可以用 PowerShell：

(Get-ChildItem "C:\Users\<用户名>\Zotero\storage" -Directory).Count

macOS 或 Linux 下：

ls -1 ~/Zotero/storage | wc -l

两个数字对不上不一定是坏事，storage里可能有历史遗留的空文件夹，也可能一个附件对应多个文件但只占一个文件夹。差几个属于正常，差几十上百就得查了。

6.2 抽样验证附件可打开

数字对上了，还得验证文件本身是好的。我的做法是按比例抽样：库小的话全抽，库大的话抽二三十个，覆盖 PDF、网页快照、图片、数据集几种类型。双击打开，看能不能正常渲染、批注还在不在。

批注这一点特别值得查。Zotero 的 PDF 批注存在数据库里，跟附件文件是分开的。如果数据库搬全了但附件没搬全，会出现"批注记录在、PDF 打不开"的情况；反过来如果只搬了 PDF 没搬数据库，批注就全丢了。抽查几条带批注的文献，能同时验证两条链路。

网页快照也要抽。快照是一整个文件夹，里面有 HTML 和资源文件，比单个 PDF 更容易在复制过程中丢文件。打开快照看排版是否完整，图片有没有加载出来。

6.3 留一份可回滚的冷备

迁移完成、核对通过之后，别急着把旧的备份删掉。我的做法是保留至少两周，期间正常使用，确认没有隐蔽问题之后再清理。清理的时候也不是全删，而是保留最近一次的完整冷备，放在另一块物理硬盘上，跟工作盘分开。

冷备的命名建议带上日期和版本号，比如Zotero_20250315_v7，一眼能看出是什么时候、什么版本。备份内容就是整个数据目录加配置目录，压缩成一个包。这样下次再迁移，直接拿最新的包，不用重新琢磨路径。

最后分享一个我自己的小习惯：每次做完迁移，会在库里的某个固定条目笔记里记一行"迁移日期 + 来源机器 + 版本号"。这个习惯看起来多余，但当你一年后再次迁移、想追溯上一次是什么时候做的、当时用的什么版本，这行记录能省掉很多回忆的功夫。文献库这种东西，用久了就是一座私人图书馆，搬迁的时候多花半小时做对账，比事后花一整天找丢失的附件划算得多。