zotero/zotero · 上手攻略

  • 仓库：zotero/zotero
  • 链接：https://github.com/zotero/zotero
  • 分类：academic-writing（学术写作与文献管理）
  • 作者：spark
  • 更新：2026-07-14

是什么

zotero/zotero 是开源文献管理软件 Zotero 的官方桌面客户端源码仓库，AGPLv3 许可。Zotero 由乔治梅森大学 Roy Rosenzweig 历史与新媒体中心孵化的非营利项目开发，自 2006 年起持续维护，被视为学术写作场景里 Mendeley、EndNote 的主要免费替代品。仓库里既有 C++ 写成的桌面应用（基于 Mozilla Gecko / XULRunner / 现已迁移到 Qt + Web 引擎），也包含 React 18 前端、@citeproc-rs/wasm 形式的引用引擎以及与 Word / LibreOffice 集成的插件代码。

需要明确区分的两个项目：

  • zotero/zotero — 桌面客户端（本篇主角）。
  • zotero/zotero-connectors — 浏览器扩展（Connector），仓库独立，本文不展开。
  • citation-style-language/styles — 引文样式（CSL）数据库，配合 Zotero 使用。

本文以"用户快速上手 + 开发者源码构建"两条路径展开。

解决什么问题

学术研究里三件最烦的事，Zotero 都做了：

  1. 收集：浏览器一键抓取论文元数据、PDF、网页快照。DOI、ISBN、arXiv、PubMed、JSTOR 等数百个数据源即插即用。
  2. 整理：分集合（Collection）、打标签（Tag）、写笔记（Note）、自动查重。同步到云端后多端一致。
  3. 引用：在 Word / LibreOffice / Google Docs 中插入引文与参考文献，10 000+ 期刊的 CSL 样式开箱即用，自动按 GB/T 7714、APA、Chicago、MLA 切换。

快速安装

桌面端（普通用户）

官方下载页：https://www.zotero.org/download/ ，按系统选 macOS / Windows / Linux 安装包。最新稳定版是 7.x（仓库 package.json 的 "version": "7.0.0" 对应桌面端的 release 节奏）。

macOS：拖入 /Applications 即可。

Windows：运行 .exe 安装器。

Linux（官方 tarball，跨发行版通用）：

wget -qO- https://www.zotero.org/download/client/update/7.0.1/artifact/binary \ > /dev/null
# 实际下载地址以官网为准，命令示意
tar -xjvf Zotero-7.0.1_linux-x86_64.tar.bz2
sudo mv Zotero_linux-x86_64 /opt/zotero
/opt/zotero/set_launcher_icon
ln -s /opt/zotero/zotero.desktop ~/.local/share/applications/zotero.desktop

Debian / Ubuntu 推荐：retorquere/zotero-deb 是社区维护的 apt 包，自带 apt 升级链路，免去手动搬家。

容器化 / Chromebook：见文档 Installing on a Chromebook。

浏览器扩展（必装）

无论使用哪个桌面端，浏览器里都要装 Zotero Connector ，否则 web 抓取无从谈起。Chrome、Firefox、Edge、Safari 都有。

同步

注册 zotero.org 账号后，免费配额是 300 MB 库元数据无限 + PDF 同步 300 MB；学术邮箱（.edu / 机构域）可申请无限 PDF 同步，写邮件给 support 即可。

核心用法

收集文献

  • 在论文页（如 IEEE Xplore、CNKI）点击浏览器右上角 Zotero 图标，自动识别并抓取元数据 + 抓 PDF。
  • 命令行拖拽：将本地 PDF 拖进 Zotero 窗口，会触发元数据识别（DOI / arXiv ID）。
  • 通过 ISSN / ISBN 批量导入：菜单 File → New Library by Identifier。
  • 从其他工具迁移（EndNote .enl、Mendeley、Marginnote）走 File → Import。

整理

  • Collection：嵌套文件夹，仅本地视图，可共享。
  • Tag：跨集合打标签，搜索快。
  • Saved Search：保存检索条件做 RSS-like 订阅。
  • Note：自带富文本编辑器，可贴代码块 / 公式（MathJax 渲染）。实验室场景可装 windingwind/zotero-pdf-translate 做 PDF 全文翻译。
  • Related Items：自动 / 手动建立文献关系网。

引用

  • Word / LibreOffice 插件：随桌面端一起装，第一次打开会要求安装宏，按提示接受。
  • Google Docs：选 Edit → Add Zotero Citation，需 Chrome Connector。
  • CSL 样式切换：在 Word 插件里直接 Document Preferences → Citation Style，支持 GB/T 7714-2015、Chicago、APA、Nature 等。
  • 多语言样式：仓库 https://github.com/citation-style-language/styles 现成。

命令行小技巧

仓库本身是 GUI 客户端，没有 CLI 入口；但日常可以用 Better BibTeX 插件导出 *.bib 给 LaTeX 用：

# Zotero 里右键条目 → Better BibTeX → Copy BibTeX citation
# 或者拖拽多条到 .bib 文件

典型适用场景

  • 科研写论文：医学、人文、社科、理工都通用；CSL 样式覆盖了绝大多数期刊。
  • 硕博开题 / 文献综述：Saved Search + 标签组合能很方便地按主题、年份做 group by。
  • 团队知识库：Zotero Group 库（公开或私有）支持多人协同，PDF 注释可被成员看到。
  • 教学：导师把课程阅读清单放到 Group 库，学生一键 import 即可。

坑与注意

  1. 同步配额：300 MB 不算大。经常跑文献综述建议申请机构邮箱无限同步，或自建 WebDAV（设置 → 同步 → "Use WebDAV"，指向 Nextcloud / Seafile）。
  2. Word 插件宏安全：Word 会弹"是否启用宏"，必须允许才能在 Zotero 里点"Insert Citation"不报错。
  3. PDF 识别失败：扫描版 PDF 没有文本层，识别率 0；可以先跑 OCR（zotero-pdf-translate 集成了 PDF 文本层检测）。
  4. CSL 样式找不到：去 zotero.org/styles 搜，下载 .csl 双击安装。
  5. 数据库体积：库本体是 SQLite，过 5 万条后搜索会变慢；建议按学科 / 项目拆多个库。
  6. 升级风险：7.x 之前是 XULRunner 内核的老版本，跨大版本升级有时会丢插件；升级前先在 Help → Debug Output 看一眼日志。

与同类对比

工具 价格 引文样式 浏览器抓取 协作 同步
Zotero 免费，AGPLv3 10 000+ CSL 强，500+ 翻译器 Group 库 300 MB/无限（学术）
Mendeley 免费但被收购 中等 中 强 2 GB
EndNote 一次性付费 ¥ 强 弱 弱 Web（贵）
Paperpile 订阅 $ 中 强 Google Drive Google Drive
JabRef 免费，BibTeX 取决于 .bib 无 git 无

对中文用户：Zotero 的 GB/T 7714 样式比 Mendeley 准，配合 Better BibTeX 写 LaTeX 论文非常顺。

一句话推荐结论

Zotero 是当前最值得长期投入的免费文献管理工具；7.x 桌面端稳定，Connector + CSL + 学术邮箱无限同步三件套到位后，几乎可以无脑替代 EndNote。