我记得第一次被Zotero“拯救”，是在写论文改参考文献改到崩溃的那个下午。手动维护序号、手动调整格式、在Word里从第1条改到第87条，每一次插入新文献都像在走钢丝。那时我才意识到，文献管理根本不是“排版问题”，而是整个研究流程的基础设施。后来我花了一个周末把Zotero从安装到插件、从翻译到报错处理完整摸了一遍，今天这篇文章，就是想把这条从“入门”到“门清”的路线完整复述出来。
这不是一篇只讲“怎么装”的教程。Zotero真正难的不是安装，而是两件事：第一，理解它的数据组织方式；第二，把翻译、抓取、同步、附件管理这一整套生态拼起来。尤其是这两年Zotero 7+版本全面普及，插件机制、界面逻辑都有了变化，网上的老教程大半已经过时。我会结合自己实际踩过的坑，把安装配置、浏览器扩展、翻译插件、OCR、中文文献处理以及最经典的“the attached file is not available”报错，一条条拆开讲清楚。
1. 为什么折腾一圈，最后留在Zotero
1.1 文献管理工具的本质
在说Zotero之前，得先想明白一件事：文献管理工具到底在替你做什么？我的答案是三件事——收集、组织、引用。收集是指从网页、数据库、PDF里把文献信息抓进来；组织是指给这些条目分类、打标签、关联附件；引用是指在写作时一键生成参考文献格式。
市面上的工具很多，EndNote、NoteExpress、Mendeley、ReadCube、Papers我都短暂用过，最后沉淀到Zotero的原因很朴素：
对比维度
Zotero
EndNote
NoteExpress
Mendeley
价格
免费开源
付费授权
付费授权
免费但限制
数据存放
本地+自有WebDAV/官方同步
本地+官方同步
本地为主
在线为主
插件体系
极其丰富
一般
一般
较少
中文文献适配
配合Jasminum很强
一般
较好
一般
附件管理
存储/链接灵活
有限
有限
尚可
我见过很多人在选型上花大量时间，其实核心就一条：你的文献库是实实在在的资产，这个资产必须能离线打开、能整体备份、能随时迁移。Zotero的数据全部保存在本地固定目录，官方同步只是多设备之间的桥，不绑定你的数据。这一点让我非常安心。
1.2 Zotero 7+ 带来的质变
如果你看的是两三年前的教程，请先忘掉里面跟插件安装方式相关的内容。Zotero 7不是小版本更新，而是底层框架的大变动：
界面整体换成了新的视觉风格，PDF阅读器内置了，不再需要单独打开外部PDF阅读器；
插件升级为 .xpi 安装包，旧的 .zotero6 插件不能直接用了；
对PDF的元数据识别、批注高亮、OCR支持都有增强；
内置了翻译功能接口，可以配合翻译插件实现全文翻译和分屏翻译。
所以这篇文里凡是涉及插件的地方，我都默认你用的是 Zotero 7+。如果你还在用6.x，建议先升级再把本文当参考，否则有些位置对不上。
2. 安装、数据目录与第一个条目
2.1 下载与安装，Linux/银河麒麟也有一席之地
Zotero的安装本身没什么玄学，去官网下载对应平台安装包即可。Windows直接运行安装程序，macOS拖入Applications，这里不展开。真正容易出问题的是Linux环境，尤其是国产操作系统。
以银河麒麟这类基于Linux内核的系统为例，Zotero官网会提供 Zotero-xxx_linux-x86_64.tar.xz 和对应的 .deb 包。两种方案我都试过：
用tar.xz压缩包：解压后直接进目录运行 ./zotero。优点是干净、不污染系统，缺点是桌面快捷方式和图标需要自己创建。
用deb包：sudo dpkg -i zotero_x.x.x_amd64.deb，更符合常规软件的安装习惯，菜单里自动出现图标。
在银河麒麟上我实际遇到过一个坑：解压后双击脚本没反应，界面起不来。排查后发现是缺少GTK相关的运行库。在新立得或终端里补装依赖就好：
BASH
复制
1
sudo apt install libgtk-3-0 libx11-xcb1 libxkbcommon-x11-0
装完再启动就正常了。需要提醒的是，依赖库的名称和系统版本有关，用系统自带包管理器搜索 gtk、glib 关键词基本能解决。
2.2 数据目录：比安装更值得关注的事
安装完之后，大多数人直接点进去就开始创建条目，这会给自己埋一个隐患：你的文献库到底存在哪个路径，心里没数。
Zotero的数据目录（Data Directory）默认在用户目录下的 Zotero 文件夹，里面有 storage、styles、zotero.sqlite 等。zotero.sqlite 是核心数据库，所有条目信息都在里面；storage 存放每个条目对应的PDF等附件。
我的建议是，安装后第一件事就把数据目录迁移到有足够空间、且你心里清楚的磁盘位置。打开 编辑→设置→高级→数据存储位置，选择自定义路径。比如我放在 D:/Research/ZoteroData，而不是C盘用户目录，原因很简单：系统盘重装时不会误伤数据，整库备份时路径清晰可找。
在Linux/银河麒麟环境下同理，用 ~/.zotero 默认路径通常没问题，但如果你有挂载的数据盘，把它放到数据盘更稳妥。数据目录就是你的文献资产的“保管箱”，比软件本身重要得多。
2.3 建立第一条文献的三条路径
Zotero 7的界面是经典三栏：左侧分类树、中间条目列表、右侧详情面板。创建条目的路径主要有三种，我建议都学会：
手动录入：点绿色加号→期刊文章，然后手填作者、标题、期刊等。适合没有DOI的老文献或特殊资料。
通过DOI或ISBN获取元数据：点魔法棒图标，输入DOI号，Zotero会联网把作者、期刊、卷期页码全部拉过来。这是最省力的方式，前提是文献在网络数据库中能查到。
从PDF导入元数据：这是Zotero 7最值得称道的功能。直接把一个PDF拖进界面，Zotero尝试从PDF元数据或内容中识别标题、作者、DOI，自动补全条目。实测英文文献识别率非常高，中文文献偶尔丢DOI，需要手动补充。
创建完第一条文献，你已经走完了“最小闭环”：条目有了，元数据有了，PDF附件也关联上了。接下来要考虑的是怎么让这个过程自动化，这就必须聊浏览器扩展。
3. 浏览器扩展：网页抓取才是Zotero的灵魂
3.1 Connector的安装与正确用法
如果你只在Zotero里手动录数据，那最多只能说你“会用”，谈不上“门清”。Zotero真正高效的地方在浏览器端：打开一篇文献页面，点一下按钮，条目和PDF就全部进库了。
实现这个靠的是官方扩展 Zotero Connector。Chrome、Edge、Firefox都有，直接在扩展商店搜索“Zotero Connector”安装即可。装完后浏览器工具栏会多出一个Zotero图标，前提是你的Zotero桌面版在后台运行。
它的逻辑是智能感知当前页面类型：
页面类型
点击后行为
期刊论文页（Nature、Science、IEEE等）
保存条目+可下载的PDF
数据库搜索页（PubMed、Web of Science等）
给出保存该条目的选项
CNKI或百度学术等中文学术页
保存条目，尝试抓取PDF
普通网页
保存为网页快照
在线书店/图书馆目录
按书籍保存
我自己的习惯是：看到文献先用Connector抓进来，然后在Zotero里统一“体检”——检查作者是否识别完整、期刊名是否正常、PDF是否下到了。抓取只是第一步，整理才是你文献库质量的来源。
3.2 识别失败的几种常见场景与手动兜底
Connector不是万能的，我列几个高频翻车场景：
页面被付费墙挡住，下载不了PDF：这时Connector通常只保存了条目，没有附件。千万别直接删条目，先复制DOI，到可获取全文的渠道把PDF下载下来，然后拖进Zotero条目详情页的附件区。
数据库页面是框架页（尤其是国内某些数据库）：识别时可能拿到的只是外层页面的标题。兜底方案是找到文献详情页（带摘要的完整页面）再点Connector，或者回到Zotero用DOI魔法棒。
一篇文献对应多个PDF（正文+补充材料）：Connector有时只抓正文，有时会弹窗问你抓哪个。如果没弹，先进条目看有没有附件缺失，再手动补。
网页本身很冷门，无结构化数据：Connector会保存为“网页”类型。此时要么接受现状，要么手动编辑条目类型为期刊文章。
记住一个原则：Connector给出的永远是“尽可能”的识别结果，不要无条件信任。每次抓完，花三秒钟扫一眼右侧详情栏，很多后续问题都能避免。
3.3 抓取之后：元数据乱了的自我拯救
抓进来的文献偶尔会有作者顺序错乱、期刊名带超链接、标题大小写不统一的情况。我一般在Zotero里做三件小事：
右键条目→“从PDF检索元数据”，前提是PDF已在附件里，Zotero 7会重新识别一次；
对中文文献使用Jasminum插件（后面细讲）重新刮削CNKI的元数据；
用“查找可用的PDF”按钮，让Zotero自动从网络数据库匹配并补充全文。
这些操作做完，文献库的质量才能从“能看”变成“可靠”。你别小看这一步，等写论文要生成参考文献时，一个错误的作者缩写会让格式乱得你想删库。
4. 插件生态：翻译、OCR与中文文献的三板斧
4.1 插件安装的正确姿势（Zotero 7+）
Zotero 7+安装插件的方式和旧版完全不同。现在你只需要：
在Zotero中点击 工具→附加组件；
点右上角齿轮图标→“从文件安装附加组件”；
选择下载到的 .xpi 文件；
重启Zotero。
如果你是从官方插件页面安装，也可以“通过附加组件URL安装”。需要注意的是，Zotero 7官方应用商店界面里会显示兼容版本，尽量选明确标注支持7.x的插件。我在升级Zotero 7后曾装过一个很老的翻译插件，结果直接导致主界面卡死，最后只能进安全模式禁用插件，才救回来。安全模式是Zotero的自我保护机制，如果你装完插件崩溃，重启软件时按住 Shift 可以进入安全模式，把所有插件临时禁用，再逐个排查。
4.2 翻译插件与DeepL/DeepLX密钥：一步步说清楚
翻译是使用Zotero读英文文献最刚需的功能。“Translate for Zotero”或“Zotero PDF Translate”这类插件的核心逻辑其实不复杂：选中PDF中的一段文字，插件把它发送给翻译服务，再把译文显示在侧栏或分屏区域。
很多人卡在配置阶段，核心问题是“怎么获得密钥”。这里要区分两种路线：
路线一：用DeepL官方API
去DeepL官网注册开发者账号，在账户后台可以创建API Key。免费用户有每月少量字符的额度，个人轻度翻译一般够用。拿到Key之后，在翻译插件设置里选择DeepL，把API Key粘贴进去，语言选好即可。
路线二：用DeepLX自建翻译服务
DeepLX是一个开源自托管的翻译API服务，它把DeepL的免费网页翻译能力封装成了本地接口。部署成功后你会得到一个本地地址，例如 http://127.0.0.1:8787/translate。在翻译插件里选择自定义服务，把服务地址填进去，实测速度和稳定性都相当不错，而且不需要官方API付费密钥。
这里必须提醒一句：DeepLX的“密钥”其实不是密钥，是你部署服务后暴露出来的本地API地址。别人经常问“怎么获得秘钥”，实际上只要把自定义接口URL填对就行。如果填了但连不上，先确认服务进程有没有起来，在浏览器里直接访问那个地址看是否有响应。
4.3 “Translate for Zotero无法使用”的完整排查链路
这个报错是热搜词里的高频问题，我见过太多人卡在这一步。既然叫“排查链路”，就不要跳过中间环节，按顺序来：
第一步：确认插件本身加载成功
打开Zotero已有翻译文本，如果可以翻译就跳过；如果点翻译无反应，看右下角是否有错误弹窗。确认 工具→附加组件 里翻译插件状态是不是“已启用”。
第二步：确认翻译服务配置正确
不同的插件版本设置项名称不太一样，常见的是“Translation Services”“翻译服务”或“Endpoint”。检查你填的API地址/密钥有没有多余空格、HTTP还是HTTPS、端口号对不对。我见过最离谱的错误是有人把密钥末尾的换行符也复制进去了，导致鉴权失败。
第三步：确认Zotero的接口输出
Zotero里有自己的调试输出窗口：帮助→调试输出日志视窗。打开后尝试触发一次翻译，看里面有没有403、401、ECONNREFUSED之类的关键词：
401/403：密钥无效或服务拒绝访问；
ECONNREFUSED：本地服务没启动或端口不对；
timeout：服务地址不通或网络受限；
empty response：返回结果为空，大概率是请求格式不匹配插件版本。
第四步：测试翻译服务本身
如果用了DeepLX，直接在浏览器访问 http://127.0.0.1:8787，或发送一个简单的POST请求。如果服务返回正常JSON，那问题就一定出在插件配置而不是服务端。
第五步：考虑Zotero版本兼容性
Zotero 7大版本更新后，不少旧翻译插件是用旧宿主架构写的，表现为：装了不报错，一翻译就白屏或没反应。解决方法是去GitHub上找该插件的release页面，下载for Zotero 7的分支版本。用旧插件硬扛新版，属于最常见翻车原因。
按这套链路走下来，90%的“无法使用”都能定位到具体环节。剩下的10%往往是系统网络环境问题，我一般建议换个网络环境或检查防火墙是否拦截了本地端口。
4.4 其他值得装的插件：Jasminum、OCR、引用计数的实测感受
除了翻译，我强烈推荐以下几款，都是实测提升效率的：
Jasminum（茉莉花）：专门解决中文文献元数据问题。安装后，在CNKI等页面用Connector保存文献，元数据经常不完整，茉莉花的作用就是重新抓取期刊、作者、卷期页码。我下载中文文献PDF后，会在Zotero里右键条目→“茉莉花”菜单→更新元数据，非常顺滑。它还把中文作者的拼音/汉字姓名处理得比官方好很多。
zotero-ocr：当你有大量扫描版PDF且需要搜索或复制文字时，OCR插件可以在Zotero内部对PDF做文字识别层。配置时需要有本地OCR引擎，装好之后对老文献十分友好。扫描版PDF在阅读器里选中文字是空白的，跑一次OCR就能解决。
Zotero Citation Counts：在条目右上角直接显示Google Scholar或Crossref的引用次数。不打开网页就能知道一篇文献的影响力，强烈推荐给做文献调研的人。
Better BibTeX for Zotero：如果你写论文用LaTeX/BibTeX，这个插件能把Zotero条目导出为规范的BibTeX key，并支持引文key自动更新。虽然不是所有人的刚需，但一旦用起来就回不去。
插件别装太多，装五六个真正解决痛点的就够。装多了一是启动变慢，二是互相冲突排查困难。我现在的插件列表只有四个：Zotero PDF Translate、Jasminum、zotero-ocr、Zotero Citation Counts。
5. “The attached file is not available”——附件报错的根因与修复
5.1 这个报错到底在说什么
在Zotero里双击PDF附件时，偶尔会弹出“The attached file is not available”或者中文界面下的“附加文件不可用”。这话听着吓人，好像文献文件丢了，实际上大部分时候是Zotero的路径解析出了问题。
要理解这个报错，先得明白Zotero对附件有两种管理方式：
存储副本（Stored file）：文件被Zotero复制到数据目录下的 storage 文件夹，由Zotero统一托管。此时的文件不依赖原始下载位置，哪怕你删了原来的PDF，库里的副本还在。
链接文件（Linked file）：Zotero只记录一个指向原始PDF路径的“快捷方式”，文件本体在哪完全取决于那个路径是否有效。原文件一移动，链接就断。
报错“attached file is not available”绝大多数情况指向第二种，或者第一种文件确实从 storage 里被误删了。
我曾经折腾过一整晚排查这个报错，最后发现原因特别哭笑不得：我把下载文件夹的PDF手动整理到了“已读”子目录，Zotero里的链接还指着旧路径。你移动了文件，Zotero却没有跟着移动，自然就找不到了。
5.2 分场景排查：从路径到同步的一步步走法
遇到这个报错，我建议按这个顺序排查：
场景A：右键条目→查看附件→发现“链接文件”标成了绝对路径，且文件确实不在该路径
处理办法是重新关联文件。点击该链接文件，右键选择“查找可用文件”（Find Available File，如果有的话），或者直接把正确的PDF从资源管理器拖进条目附件栏。如果原来的文件真的被移走了，找到它的新位置，拖进去即可。
场景B：附件显示为“已存储”，但双击仍然报错
这种情况说明 storage 目录里对应的子文件夹缺失。你先到数据目录的 storage 下找有没有同名的8位数字字母文件夹，没有的话说明附件已在某次同步或误操作中丢失。解决办法只能是找回源PDF重新拖入，或者从官方同步云端恢复。所以，重要文献一定要定期备份数据目录。
场景C：在多台设备间同步，某台电脑上文件不可用
典型的同步时序问题。Zotero官方同步分两步：数据库同步（把条目信息同步到官方服务器）和文件同步（把 storage 里的附件同步）。如果数据库同步先完成，条目已经出现在新电脑上，但文件同步还没下载完，此时双击就会报错。解决办法是：
在Zotero的 编辑→设置→同步 里，查看同步状态；
点击“立即同步”，等待文件同步进度跑完；
如果文件体积很大，检查是否同步被中断。
场景D：链接路径本身包含中文/特殊字符导致的解析异常
在Windows系统上，链接文件的路径如果包含特殊字符或者很长的路径，Zotero偶尔无法展开。尽量让附件路径全英文、层级简单，减少这种边界问题。
5.3 预防附件失效的四个习惯
排查归排查，真正的高手都是预防问题的。我基于过去的教训总结了四条：
优先用“存储副本”，少用“链接文件”。入口在 编辑→设置→常规→文件处理→将下载文件存入附件文件夹并创建存储链接。除非你硬盘容量实在紧张，否则让Zotero管理文件副本是最省心的。
给Zotero同步开一个相对稳定的数据目录位置。不要心血来潮把数据目录放到U盘或移动硬盘，挂载状态一变，整库报错。
定期备份。关闭Zotero后，把整个数据目录压缩保存一份，或者用同步盘同步数据目录（注意冲突问题），一个月一次足够，但要有这个习惯。
源文件PDF不要反复移动。如果你习惯把人肉下载的PDF手动拖入Zotero，拖完之后原始那份就可以删掉或归档，不要把两份都留着然后频繁整理，很容易制造断链。
我自己的数据目录现在是 D:/Research/ZoteroData，每个月最后一天会压缩拷贝到另一块存储上。这个习惯帮我躲过了至少三次灾难性事故，强烈建议你也养成。
6. 我现在的Zotero工作流与最后想说的话
6.1 一套可供参考的完整工作流
梳理一下我日常用Zotero做文献调研的标准流程，给大家一个完整的参考链路：
发现：日常刷到或检索到文献，在浏览器当前页确认是不是目标文章；
抓取：点Connector按钮，让Zotero把条目和PDF一起存起来；
清洗：回到Zotero，右键看详情，中文文献用茉莉花更新元数据，英文文献检查DOI和期刊名；
归档：拖入对应的分类文件夹，顺手打上标签（研究方法、数据集、综述等）；
阅读：在Zotero内置的PDF阅读器里高亮、批注，关键段落用翻译插件分屏看；
写作：需要在Word里引用时，打开Word插件，搜索条目，插入引用，最后统一生成参考文献表。
这套流程前后连贯，Zotero既是收集器，也是阅读器，还是写作引用引擎。你不需要在好几个工具之间来回切换，这也是它作为“文献管理神器”的底气。
6.2 最后想分享的几个经验教训
写了这么多，最后说几句掏心窝子的话。
第一，别在收藏夹里吃灰，要让文献库动起来。Zotero用得好不好，不在于装了多少插件，而在于有没有形成自己的整理和阅读节奏。
第二，定期关注Zotero官方论坛和插件的GitHub release页面。Zotero更新较快，插件兼容性变化也快，常看这些地方能让你的配置少踩坑。
第三，所有工具都是为研究服务的，不要为了折腾工具本身忘记正事。我把Zotero摸熟之后，最大的感受是：工具的价值体现在它能隐形，当你不再意识到它的存在、只是顺手就能把文献管好时，它才算真正发挥了作用。
如果你正准备用Zotero，这篇文章的路线足够你从零起步到解决日常问题；如果你已经用了很长时间但始终感觉不顺手，建议重点看第4章和第5章，大概率能对症找到答案。文献管理这件事没有一劳永逸的配置，但每解决一个具体问题，你的工作流就会更顺一点。这也是“门清”的真正含义。