Zotero 搬迁后附件丢失？先审计路径，再重新链接

更改前先保留路径证据

“找不到文件”只证明 Zotero 无法按当前记录解析附件，并不证明 PDF 已经消失。更改“链接附件基础目录”、接受自动重新链接或执行批量替换前，先记录仍能看到的路径并给每个附件分类。

审计期间不要编辑 zotero.sqlite，也不要再次移动 PDF 目录。过早修改会抹掉解释“文件从哪里移走”的旧前缀。

区分已存储附件和链接文件

已存储附件位于 Zotero 数据目录中，可以使用 Zotero 文件同步。链接附件指向电脑其他位置，不包含在 Zotero 文件同步中。两者需要不同的修复分支。

打开几个受影响的父条目，把附件记录为“已存储”“链接”或“未知”。如果另一台电脑仍能打开链接附件，先把它当作已知正常参照，不要在那里试错。

建立只读审计表

每个附件一行。建议列出：引文标签、附件标题、附件类别、旧完整路径、旧根前缀、相对后缀、候选新根目录、候选完整路径、精确文件是否存在、同名文件数量、已知正常设备、审计状态和建议动作。

少量记录可以手动复制路径；较大的已选集合可使用 Zutilo 的“查看附件路径”和“复制附件路径”。其文档说明后者会复制文件附件的完整系统路径。把输出当作清单证据，不要当作修改授权。

测试候选根目录，不按文件名猜

确认重复出现的旧根目录后，保持原路径列不变，把相对后缀与每个候选根目录拼接到单独列中，并在磁盘上测试那个精确路径。

绝不能只凭文件名重新链接。若多个候选文件同名，把该行标为“有歧义”，手动比较文档内容、大小和日期。审计不得猜测哪个 PDF 对应哪条引文。

分配五种审计状态

同一前缀映射有效且所有抽查后缀都存在时，标为“共同根目录可恢复”；少量一对一目标已验证时，标为“单项可恢复”；多个文件或根目录都可能匹配时，标为“有歧义”；已存储附件在不同设备或 Web Library 表现不同时，标为“同步诊断”；没有任何已验证副本时，标为“文件字节缺失”。

“未知”也是有效结果。保留未解决记录，比静默链接到错误文档安全。

选择最小且已验证的修复

链接文件共享同一个父目录时，在各台电脑设置相同的“链接附件基础目录”，先测试一小组。Zotero 文档说明，该目录下的链接路径可用相对方式保存；找到移动后的文件时，Zotero 也可能提出自动重新链接。

当工作表证明只有一个明确的旧前缀到新前缀映射时，Zutilo 文档提供“修改附件路径”。只在小型已选批次中开始。它会修改记录，但不会验证文件身份，也不会移动文件。

如果原电脑仍能打开链接文件，而你希望由 Zotero 文件同步管理它们，可使用“将链接文件转换为已存储文件”。先确认存储容量并用小批量测试。

把同步故障留在独立分支

已存储附件丢失可能是文件同步问题，而不是路径迁移问题。检查文件能否在 Zotero Web Library 或另一台已同步电脑上打开。不要把链接路径工具用于已存储附件。

按设备记录证据。只在一台设备存在的文件，应先保存并决定同步方式再清理；所有位置都不存在的文件，无法靠更改路径设置恢复。

批量修复前必须通过退出测试

只有在明确附件类别、旧前缀、候选根目录、受影响行数、有歧义行数和回退来源后，才继续。抽查浅层路径、深层路径、含空格文件名、重复文件名，以及最大受影响文件夹中的文件。

测试后必须从 Zotero 内打开每个附件，而不是只在文件管理器中打开。任何记录打开错误文档或仍有歧义，都应停止批量操作并转入人工复核。