> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/073-how-to-link-zotero-to-your-overleaf-account.md).

# 如何将 Zotero 关联到你的 Overleaf 账户

## 引言

本文展示如何将 Zotero 关联到你的 Overleaf 账户并用它来 [向你的项目中添加参考文献](#how-to-add-references-to-your-overleaf-project-using-zotero).

参考文献管理器集成是一项 [高级功能](/latex/zh-cn/zhi-shi-ku/120-overleaf-premium-features.md)。Overleaf 高级功能可供 Overleaf Commons 参与者、团队订阅成员以及个人订阅拥有者使用。

**注意**：如果你没有付费的 Overleaf 订阅，你始终可以从 `.bib` Zotero 或其他参考文献管理器软件中导出数据，并将生成的 `.bib` 文件上传到你的 Overleaf 项目中。

## 如何将 Zotero 关联到你的 Overleaf 账户

1. 选择 **账户** 然后 **账户设置** 下拉菜单中：

![展示如何访问 Overleaf 账户设置的图片](/files/cd9996cfd41b7313aa12b6ce15a3f5baec984678)

3. 在账户设置列表中向下滚动到 **参考文献管理器** 部分，然后选择 **关联** 用于 **Zotero 集成**.

![展示如何将 Zotero 关联到你的 Overleaf 账户的账户设置图片](/files/88438a8caba435e3b06298f46123a9952b68e247)

如果你尚未这样做，系统会提示你登录 Zotero 账户。

1. 如果你 *不* 已经登录 Zotero，请继续登录。
2. 你将看到 **新密钥** 页面：

![将 Zotero 关联到你的 Overleaf 账户时，Zotero 显示的新密钥页面](/files/ce2942dfe1446d09ead0f4ca13428b6c7a4429ea)

3. 选择 **接受默认设置** 即可完成将 Zotero 关联到你的 Overleaf 账户的过程。
4. 如果你 *已* 已登录 Zotero。
5. 选择 **关联** 按钮以 **Zotero 集成** 直接带你前往上面显示的 **新密钥** 页面。
6. 选择 **接受默认设置** 即可完成将 Zotero 关联到你的 Overleaf 账户的过程。
7. 成功关联 Zotero 后，你的 Overleaf 账户设置将更新，以确认你的 Zotero 账户已关联到你的 Overleaf 账户。请注意，你可以随时解除 Zotero 账户的关联。

![展示如何将 Zotero 与你的 Overleaf 账户解除关联的图片](/files/6ba8849e65f4bddfd7309f046be20b588264b020)

## 如何使用 Zotero 向你的 Overleaf 项目添加参考文献

将 Zotero 关联到你的 Overleaf 账户后，你可以通过两种方式向项目中添加参考文献。

1. 你可以导入 Zotero 的我的文库或单个群组文库来创建一个 *只读* （不可编辑） `.bib` 文件，它可以与您的 Zotero 账户同步。如果你在 Zotero 中更新参考文献数据，你可以让 Overleaf 更新（刷新）该 `.bib` 文件，以便与 Zotero 中所做的更改同步。观看下面的 [视频](#a-video-to-demonstrate-importing-zotero-references-into-an-overleaf-project) ，以演示如何从 Zotero 导入参考文献。
2. 你可以通过以下方式从你的 Zotero 账户导入单个参考文献： [配置 **高级参考文献搜索**](/latex/zh-cn/zhi-shi-ku/076-how-to-search-for-references-in-an-overleaf-project.md#configuring-advanced-reference-search-to-use-mendeley) 以在 Zotero 中查找参考文献。任何在 Zotero 中找到并随后被引用的参考文献，都会被添加到项目中的一个 *可编辑* `.bib` 文件中。

本文重点介绍选项 1， *批量导入* 参考文献以创建一个 *不可编辑的* `.bib` 文件。要了解如何导入 *单个参考文献* 到 *可编辑* `.bib` 文件，请参阅 [配置高级参考文献搜索以使用 Zotero。](/latex/zh-cn/zhi-shi-ku/076-how-to-search-for-references-in-an-overleaf-project.md#configuring-advanced-reference-search-to-use-mendeley)

### 将 Zotero 参考文献导入 Overleaf 项目

Overleaf 与 Zotero 的集成支持从“我的文库”和单个群组文库导入参考文献，但你不能选择文库中的特定文件夹：某个 Zotero 文库中的所有参考文献，以及它可能包含的任何文件夹，都会作为一个扁平列表导入。

下面的视频演示了如何从两个 Zotero 群组文库导入参考文献，以创建两个新的 *只读* （不可编辑） `.bib` 这些文件： `articles.bib` 和 `books.bib`.

#### 演示将 Zotero 参考文献导入 Overleaf 项目的视频

下面的视频使用了 Zotero 中列出的两个预先准备好的群组文库：

* TeX/LaTeX 文章
* TeX/LaTeX 书籍

它们与 Overleaf 显示的相应下拉列表一起显示在下图中：

![展示 Zotero 和 Overleaf 中群组文库的图片](/files/5fff35058ac528ea06e15d49a50d8252c57ea094)

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/1w7rJCiRDEnuc75Wm7Rxgy/0fd01a899ca963704b7114f563104703/Zotero.mp4>" %}

## 关于 Overleaf 与参考文献管理器集成的说明

Overleaf 与外部参考文献管理器的集成依赖于各个平台基于 Web 的 API（应用程序接口）所提供的功能和数据。目前，Overleaf 无法控制或修改这些 API 生成的输出，我们也不会对接收到的数据进行任何转换。该 `.bib` 添加到你的 Overleaf 项目中的文件是 API 所提供内容的直接副本，并按“原样提供”并入 `.bib` 文件中。

### 引文键

对于一组给定的参考文献， `.bib` 由参考文献管理器平台 API 生成的数据可能与通过该参考文献管理器提供的其他工具或服务导出同样参考文献所生成的数据不同。如果你在使用 Overleaf 的基于 Web 的导入和手动上传 `.bib` 从参考文献管理器对应的桌面软件或在线文库中手动导出的文件之间切换，可能会出现问题。例如，如果你通过 Overleaf 的集成使用 Zotero 的 Web API 创建了一个 `.bib` 文件，随后又通过上传一个 `.bib` 通过直接导出流程创建的文件将其替换，你可能需要检查生成的引文键是否存在差异，因为这可能会导致之前可用的引用失效。

### 更新由参考文献管理器生成的项目 .bib 文件

参考文献管理器，包括 Zotero，提供两种创建 `.bib` 文件到你的项目中的方法。

1. 一个 *批量导入* 整个参考文献库，或其某个参考文献组。
   * 此方法会向你的 Overleaf 项目添加 *只读* （不可编辑） `.bib` 文件。对只读 `.bib` 文件的任何更改或更新都必须在参考文献管理器中完成，并通过选择 **刷新** 按钮并在文件预览顶部将其传送到 Overleaf。刷新已导入的 `.bib` 文件的操作在 [上面的视频中演示](#a-video-to-demonstrate-importing-zotero-references-into-an-overleaf-project).
2. 从 *单个参考文献* 使用 [**高级参考文献搜索**](/latex/zh-cn/zhi-shi-ku/076-how-to-search-for-references-in-an-overleaf-project.md#how-to-use-advanced-reference-search-premium-feature).
   * 添加到项目中的参考文献 `.bib` 使用 **高级参考文献搜索** 仍然完全可编辑。

### 权限说明

有时你可能会看到以下错误消息——例如，在将 Zotero 关联到你的 Overleaf 账户之后，随后又使用 Zotero 更改现有群组的权限，或添加了 Overleaf 没有访问权限的新群组：

![展示 Overleaf 显示的权限错误消息的图片](/files/673599912057405b1923fb370e32ebd47cbb6654)

如错误消息所述，选择按钮 **重新关联你的账户** 以重新建立 Overleaf 访问你 Zotero 群组中参考文献所需的权限。

## 进一步阅读

* [如何将 Mendeley 关联到你的 Overleaf 账户](/latex/zh-cn/zhi-shi-ku/070-how-to-link-mendeley-to-your-overleaf-account.md)
* [如何在 Overleaf 项目中搜索参考文献](/latex/zh-cn/zhi-shi-ku/076-how-to-search-for-references-in-an-overleaf-project.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/073-how-to-link-zotero-to-your-overleaf-account.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.