两台主机之间做Zotero同步，听起来像是个五分钟就能解决的小事，真正操作起来却很容易翻车。办公室台式机上已经攒了上千条文献，晚上回家想在笔记本上接着看，打开Zotero发现条目是空的；或者两台机器各写了一半笔记，同步完成后互相覆盖，最后只能对着“冲突”对话框发呆。还有更糟的：图省事直接把Zotero数据目录放进网盘同步，结果zotero.sqlite这个数据库文件被两边的同步客户端反复覆盖，最终整个文献库报废。这篇就围绕“Zotero同步”展开，把两台主机之间同步的原理、方案、配置步骤和避坑经验一次性讲清楚，适合经常在多个设备之间切换、需要把文献库完整带在身边的研究者，也适合团队共用文献库的成员直接照做。
1. 先搞懂Zotero同步机制，别急着同步
1.1 数据同步与附件同步，其实是两条独立的线
Zotero和其他文献管理软件最大的区别，在于它把“文献条目”和“文件附件”分成了两个层面来管理。所有条目的元数据、笔记、标签、分组、阅读状态，都存在一个叫zotero.sqlite的本地数据库里；而PDF、网页快照、图片这些实际文件，则存放在storage目录或外部链接路径下。
这就意味着，哪怕你完整复制了论文条目，PDF也未必跟着过去。很多人在两台主机之间看到“条目都在但附件全打不开”或者“一台有PDF另一台没有”，根源就在这里：他们只同步了数据层，没有同步文件层。
用一个不严谨但很好懂的类比：数据同步相当于把图书馆的目录卡片复制了一份，文件同步才是把书架上的实体书运过去。目录可以瞬间复制，实体书就要考虑运输成本。Zotero官方把这两条线分开配置，好处是你可以灵活选择——有些库体积不大，全官方；有些库里面有大附件，就用WebDAV承载文件层。两者互不冲突。
1.2 同步原理里的几个关键设计
Zotero的同步本质上是基于SQLite数据库增量的双向合并，不是简单的文件导出导入。每个条目在本地都会记录版本信息，同步时把本地修改上传、把远端新内容拉下来，这个过程类似一个简化版的主从数据库复制，只是它被优化得更适合文献管理场景。
正因为如此，它比“把整个Zotero文件夹塞进网盘”的安全系数高得多。前者是应用层的逻辑同步，能处理两台设备都改过同一条目的情况；后者是文件层的物理覆盖，如果两台机器同时开着Zotero，网盘客户端极有可能把一个正在被占用的数据库文件同步过去，生成带“冲突副本”字样的半截文件，甚至直接损坏数据库。这是我在实际使用中见过的最典型的翻车姿势。
另外一个容易被忽略的设计是：Zotero的附件文件在数据库里并不以原始文件名记录，而是映射为一串随机字符目录名。你看惯了网盘里“张三的论文.pdf”这样的名字，在storage里看到的却是“ABCD1234.pdf”。这是为了规避文件路径和特殊字符冲突，不要闲着没事手动改回中文名，改了之后数据库就找不到文件了。
1.3 官方云空间和WebDAV，本质上是两种附件仓库
无论是Zotero官方云空间，还是WebDAV，它们负责的其实都是文件层同步。数据同步永远走Zotero官方服务器，这部分不需要额外配置；而附件文件同步可以选择官方空间，也可以选择WebDAV。
官方空间免费容量300MB，适合PDF总量不大的人。WebDAV则是把附件存储交给你自己指定的服务器，容量和服务商绑定，适合文献多、附件大的使用者。把这一层理解到位之后，下一步就是选方案。
2. 两台主机之间的三种同步方案，我推荐这种
2.1 官方云空间：配置最简单，但容量是硬约束
如果你用Zotero主要是管理条目、写笔记，PDF附件很少，那直接选“Zotero存储”就好。只需要在“编辑→设置→同步”里登录同一个账号，数据和附件都走官方服务器，整体链路最稳定，也最省心。300MB的免费容量看上去不多，但很多纯收录题录和笔记的文献库，几百条条目几乎不占空间，这个方案完全够用。
如果附件超过300MB，扩容要额外掏钱，价格倒也不算离谱，但很多人不愿意为一个文献库按月续费。更现实的痛点是：免费账户空间有限，更新频繁的大文献库很容易爆，爆了就报“同步失败”，用户体验很差。我的建议是，除非你的库真的非常轻，否则直接把WebDAV作为默认方案。
2.2 WebDAV：容量自控，多设备同步的性价比最优解
WebDAV就是一个基于HTTP的文件访问协议，Zotero可以在上面建立自己的目录结构，并通过LOCK机制确保同一时间只有一个客户端在安全地写数据。你在设置里填写WebDAV地址、账号、密码，Zotero就会自动完成文件层的双向同步。
选哪家WebDAV服务？国内用得最多的是坚果云，免费账户可开WebDAV，用起来也稳。注册后在“账户信息-安全选项”里生成一个应用密码，填到Zotero里就行。有自己的NAS更简单，直接在群晖、威联通这类设备上开启WebDAV并映射一个文件夹，容量随便造。甚至租一台普通云服务器自己装WebDAV服务端也可以，只是维护成本高一些，适合有动手能力的人。
有一点必须提前确认：Zotero要求WebDAV服务器必须支持文件锁定（LOCK/UNLOCK），否则附件的并发写会被破坏。大多数商用云盘和NAS自带服务都支持，但个别免费WebDAV服务商不一定支持，验证时Zotero会直接报错。遇到这种情况，换服务商比折腾配置快得多。
2.3 手动迁移方式：适合一次性搬家，不适合长期同步
如果只是换一台新电脑，不需要实时同步，那手动迁移数据目录是最直接的方案。先完全退出Zotero，把整块数据目录（zotero.sqlite和storage）复制到新电脑对应路径下，再启动Zotero即可。新机器会自动读取旧库，效果和原来完全一样。
也可以用导出-导入功能：在旧机器上全选文献导出为Zotero RDF，再到新机器导入。但普通导出只包含条目元数据和笔记，PDF附件不会跟着走，除非你勾选了“将文件存入文件夹”。实际操作中这个选项很容易被忽略，导致导入后大量附件显示“the attached file is not available”。所以我更推荐直接复制数据目录，简单直接，不会落下东西。它的缺点也很明显：不是实时的，两台机器之间新增的操作不会自动互通，只能作为一次性迁移手段，而不是长期同步方案。
2.4 三种方案怎么选
| 方案 | 优点 | 缺点 | 适合场景 |
|---|---|---|---|
| 官方云空间 | 配置零门槛、官方链路稳定 | 300MB附件容量限制、扩容需付费 | 条目多、附件少、个人使用 |
| WebDAV | 容量自控、多设备协同强 | 需要额外准备WebDAV服务 | 附件多、办公室/家里/笔记本多设备轮流用 |
| 手动复制目录 | 不依赖网络、零附加服务 | 不实时、容易漏数据 | 一次性换机、应急恢复 |
选型没有绝对标准，取决于你对同步实时性的需要和附件体量。如果两台主机长期同步，我会直接锁定WebDAV。
3. 实操：WebDAV同步配置的完整步骤
3.1 动手前的准备清单
开始之前，把这几样东西准备好，能省下后面至少半小时的排查时间：
- 两套都安装好Zotero 7。Windows直接装安装包，macOS用pkg或dmg，Linux发行版建议下载官方Linux版本或AppImage。我在国产Linux环境（比如银河麒麟）里也装过，官方发行版或AppImage方式运行都很顺畅，软件商店里的版本如果过旧，别纠结，直接AppImage最省事。
- 一个Zotero账号，两台主机用同一个账号登录。
- 一个WebDAV服务。这里以坚果云为例，免费账户就能用。注册后登录网页版，进入“账户信息-安全选项”，在“第三方应用管理”里添加应用密码，名字随便写，比如zotero，系统会生成一串随机密码。
注意，这串应用密码和你平时登录坚果云的密码不是一回事。填到Zotero里的必须是应用密码。有人图省事直接填坚果云登录密码，验证服务器时多半会得到401错误，这是配置新手最常见的坑之一。
3.2 第一台主机：先配置好同步的“源头”
第一台主机的操作顺序是这样的。打开Zotero，进入“编辑→设置→同步”，先勾选“自动同步”，再把“同步附件文件”相关选项打开。
文件同步方式里选择WebDAV，然后填写三样东西：
- URL：填
https://dav.jianguoyun.com/dav/ - 账号：你的坚果云登录邮箱
- 密码：刚才生成的应用密码
填完点“验证服务器”，如果配置正确会返回服务器通讯正常的提示。验证通过后，Zotero会在WebDAV根目录下自动创建自己的目录结构，用来存放附件和同步信息。从现在开始，这台机器上后续新增的条目和PDF都会进入同步链路。
一个小提醒：同步设置里的“附件同步”有几个层级，Zotero 7下建议把“自动同步新下载的附件”和“从其他设备下载附件”这类选项都打开。很多人只勾了条目同步，第二天在另一台电脑上看到附件全部变成灰色链接，就是这个开关的锅。宁可让文件多占点流量，也不要让附件在不同主机之间“阴阳两隔”。
3.3 第二台主机：首次同步的正确姿势
第二台主机装好Zotero后，同样登录同一账号，WebDAV三件套配置一模一样。配置完成后点“同步”，系统会先拉取条目、标签、笔记等数据，这个过程较快。
接着是附件同步，这可能就是整个流程里最耗时的一步，取决于你的文献库整体体积。几百篇带PDF的库还好，几分钟到十几分钟；如果是积攒了几年、附件有好几个GB的库，可能需要更长时间，期间不要强制退出Zotero，也不要让电脑休眠，否则同步链路很容易中断。中断后虽然可以恢复，但反复中断会导致一些临时状态卡在WebDAV里。
我的习惯是：第二台主机首次同步时，先只同步条目和元数据，日常阅读某篇文献时再让Zotero按需下载对应PDF。如果两台主机都很常用且笔记本空间充裕，再改成全量下载。“按需下载”和“全量下载”在Zotero同步设置里可以随时切换，不用重新配WebDAV，这点很友好。
3.4 日常切换设备时怎么避免冲突
同步冲突听起来很复杂，其实大部分情况下可以规避。Zotero处理冲突的机制是这样：如果两台设备修改了同一条目的不同字段，它会把两边都保留下来；如果修改了同一个字段，就会生成一个“冲突组”，让你在“工具→冲突”里人工裁决。
日常使用中我的操作纪律很简单：在办公室改完文献后，等右下角同步状态变成“已同步”再关机；到了家里打开Zotero，先同步一次，再开始写笔记或改标签。说白了，让每次修改都落进同步链路，而不是攒一批修改后一次性推过去。这个习惯养成后，我在两台主机之间切换两年，几乎没有遇到需要人工处理的冲突。
如果团队多人共用同一个资料库，那就更需要强调这个顺序，因为多人同时写入同一条目的概率比两台主机高得多。Zotero不是在线协作文档那种实时协作工具，别拿它当多人共用的实时编辑器用。
4. 同步完成后的生态维护：插件、翻译、浏览器扩展与OCR
4.1 Zotero 7 的插件兼容性问题，先说清楚
Zotero 7升级后，一个容易踩的坑是插件兼容。Zotero 6时代常用的旧版插件，很多没有自动适配新架构，装上去要么不显示，要么直接报错。凡是提示“incompatible”的插件，别硬装，去作者的GitHub Release页面找适配Zotero 7的版本，或者直接在Zotero官网插件广场搜索。
翻译插件这一块问的人特别多，尤其是“Translate for Zotero无法使用”。这个插件的原理是调用外部翻译接口（比如DeepL、百度、类GPT接口等），在PDF阅读器侧边栏直接显示译文。如果某天突然无法使用，优先检查三个地方：接口URL是否还能访问、API Key或deeplx密钥是否过期或余额不足、Zotero插件设置里的服务商是否被切换成了未生效的默认项。大部分“不能用了”都不是Zotero本身的锅，而是外部接口变了。
OCR插件也值得提一句。如果你经常要处理扫描版PDF，想让它变成可检索的全文文本，ZoteroOCR这类插件依赖本机安装Tesseract，而不是纯插件就能完成识别。Zotero 7下使用时记得把Tesseract路径和中文语言包配置好。OCR产生的文本和附件可以通过同步链路传到另一台主机，但Tesseract本体需要各主机各自安装，不能指望同步把系统依赖也带过去。
4.2 浏览器扩展与移动端：同步生态里的另两个入口
Chrome浏览器的Zotero Connector（在主流浏览器都有对应版本）负责从网页上一键抓取文献元数据和全文。抓到的内容会先写入当前打开Zotero的这台主机，然后通过同步链路跑到另一台主机。这就产生一个时间差：在A电脑上抓取的文章，B电脑上不会立刻出现，需要B电脑执行一次同步。很多用户以为装了两个扩展会自动互通，其实扩展本身不传数据，传输的角色是Zotero的同步服务器加WebDAV。
移动端App是另一个典型场景。如果在通勤路上用手机或平板读了文献、做了批注，回办公室打开台式机同步一下，批注就会出现在Zotero里。App的同步设置里同样支持配置WebDAV，把账号和应用密码填对就能和桌面端共用同一个附件仓库。需要留意的是，移动端App的体验比较轻量，适合阅读、批注和快速检索，不适合大规模整理资料库，大量的批量操作还是在桌面端做更稳妥。
4.3 附件同步细节：本地磁盘与远端之间的取舍
当附件仓库托管在WebDAV上之后，有一些存储策略值得提前规划。首先是“全量下载”与“按需下载”的选择：笔记本硬盘小的，强烈建议用按需下载；台式机或主力工作机，建议全量保留。这样主力机能离线读文献，移动设备省空间，两边都不吃亏。
其次，不要手动去改storage里的文件名。Zotero的storage名称是随机字符，它和数据库里的附件记录一一对应。如果你为了“好看”把storage里的PDF改成中文名，数据库就找不到对应文件，轻则显示附件不可用，重则同步时制造出一堆错误状态。想整理文件名，应该使用Zotero的文件重命名功能或相关插件，而不是直接动存储目录。
最后是附件下载完整性的自检。在某台新设备上首次同步之后，可以挑几个已知有附件的条目试开PDF，确认能正常打开再收工。别等到提交论文时才突然发现某篇关键文献在笔记本上是坏的。
5. 同步高频问题排查与避坑实录
5.1 The attached file is not available 到底怎么解决
这是同步场景下最高频的报错之一，出现时Zotero会显示附件链接不可用。常见原因有三个：附件还没有被下载到当前设备；数据库里记录的附件路径与本地实际文件不匹配；或者你之前手动移动过storage目录里的文件。
排查顺序建议这样：先看附件所在条目有没有同步成功，没有就点同步等它下载；再看文件是否真的存在于本机storage目录；最后在条目上右键“管理附件→重新链接文件”，手动指向正确的PDF路径。这套组合拳可以解决绝大多数“附件不可用”的问题。如果还是不行，检查WebDAV服务器里对应的文件是否正常存在——问题可能出在远端而不是本地。
5.2 同步一直转圈、无限循环、数据库异常
同步卡住最常见的原因是网络到WebDAV服务器的链路不稳定。坚果云这类服务偶尔有传输高峰，大文件或大批量小文件同时同步时容易超时。你可以先把自动同步关掉，改成手动同步，分批次地同步，避免一次塞几千个文件。
如果发现某条记录反复同步、怎么都结束不了，多半是这条记录在WebDAV上的状态和本地状态产生了死锁。处理办法是把冲突窗口打开看看，有冲突则直接处理掉；没有冲突就尝试“忽略”这条记录的同步状态，或者在Zotero官方论坛里搜索对应报错。
数据库层面报错——启动时提示数据库损坏或发现旧版本副本需要重置，是比较严重的故障。遇到这种情况，第一反应应该是去找备份，而不是让Zotero重建数据库。把Zotero配置目录里的zotero.sqlite用历史备份替换回来，重启后大概率能恢复到之前的完整状态。
5.3 WebDAV验证失败、连接不上的排查方向
验证服务器时如果收到401，绝大多数是账号或密码错误。账号要填WebDAV服务的完整邮箱（坚果云场景），密码要填应用密码而不是登录密码。收到404或路径错误类提示，则检查URL——是不是少写了dav根路径、是不是把http和https写错了、服务商给的地址是否已经更新。拿到服务商文档看一眼，比自己猜快得多。
验证通过但同步偶尔失败，也要分情况。如果是免费版坚果云且同步量大，可能触发了每月流量限制，这种情况只需要错峰同步，不必过度紧张。如果是自建NAS，先检查WebDAV服务是否正常启动、防火墙是否放行、目标文件夹是否设置了正确的读写权限。NAS用户常见误区是只开了WebDAV但忘了给Zotero子目录写权限，导致Zotero能连接但写不进去。
5.4 防患于未然的备份习惯
同步解决的是“多台设备内容一致”，不等于“数据绝对安全”。WebDAV服务商本身可能出问题，也可能因为操作失误把同步不完整的库当成了最新版本。所以备份习惯仍然不能少。
我的做法是：每个月至少做一次完整备份。备份之前退出Zotero，把配置目录下的zotero.sqlite和storage整体复制到本地另一个硬盘以及云盘里。Windows的默认路径在“运行”里输入%APPDATA%\Zotero\Zotero\Profiles可以看到；macOS在~/Library/Application Support/Zotero；Linux一般在~/.zotero/zotero。具体profile子目录因人而异，但找起来不难。
另外每次升级Zotero版本前，必做一次备份。文献管理工具的升级翻车概率虽然不高，但一旦遇到损坏，损失的可能就是好几年的文献积累。一次备份的成本不过几分钟，这笔账怎么算都划算。
| 问题 | 快速定位要点 |
|---|---|
| 附件不可用 | 同步是否完成、文件是否存在、重链接文件 |
| 同步一直转圈 | 网络链路、自动同步开关、分批次手动同步 |
| WebDAV 401 | 账号/应用密码是否正确、URL是否匹配服务商 |
| 数据库损坏 | 找历史备份并恢复，别急着重建 |
| 插件装不上 | 检查是否兼容Zotero 7、去官方或作者GitHub下载 |
我自己的电脑配置是：台式机做主力，文献全量入库；笔记本和手机走按需下载，基本上睡前想读哪篇就临时拉那篇，磁盘压力小，长期跑下来比较舒服。我还有一个习惯——每次给新设备配置同步，都会先在一两篇文献上做“加入→同步→打开附件”的完整冒烟测试，配置正确再正式迁移大库。如果你正在解决两台主机之间的Zotero同步问题，按上面这几步配置完，再把第5节的排查表截图存一份在手机里，这个环节基本可以画上句号了。文献库这东西，平时看着不起眼，一旦弄丢一次，谁疼谁知道，愿你的资料永远稳稳当当。
