# 源码与 PDF 同步

从光标跳转到 PDF 中对应的位置，或按住 Cmd/Ctrl 点击 PDF，定位到源码中的那个词。LaTeX 通过 SyncTeX 实现，Typst 同样支持，并可跨文件使用。

源码与 PDF 同步把你所写的内容与排版后的页面联系起来。在 LaTeX 中它基于 SyncTeX：Oleafly 每次构建都会启用 SyncTeX 数据。在 Typst 中它通过 Typst 语言服务器实现，所以同样的跳转无需额外设置。两个方向都只需一个手势。

## 源码到 PDF：⌘⇧J

![跳转到 PDF 是编辑器工具栏最右侧的箭头，位于查找和项目信息旁边。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=1799,76,119,49)

把光标放在任意一行，按 ⌘⇧J（Ctrl+Shift+J）。PDF 会滚动到对应位置，并在那里短暂闪现蓝色高亮，让你的视线正好落在光标所在之处。

你也可以使用编辑器工具栏最右侧的箭头、编辑器的右键菜单，或 ⌘K 命令面板。LaTeX 项目把这个命令称为**跳转到 PDF（SyncTeX）**，Typst 项目则称为**跳转到 PDF**。

它适用于多文件项目。光标位于 `chapters/methods.tex` 中时，可以在合并后的 PDF 里找到它排版后的位置，因为 SyncTeX 会沿着你的 `\input` 结构查找。Typst 对主文档所包含的文件也是如此。

![点击 PDF 中的一个词，就会跳到源码里的同一个词。](https://cdn.oleafly.com/images/gifs/desktop/pdf-to-source.gif?v=2)

## PDF 到源码：⌘ 点击

按住 **⌘** 或 Ctrl，PDF 上的指针会变成十字准星。点击一个词，即可跳转到编辑器中的对应位置。如果文本来自另一个文件，例如 LaTeX 中被 `\input` 的子文件或被包含的 `.typ` 文件，Oleafly 会先打开正确的文件。

Oleafly 会把光标放在你点击的那个词上，而不是行首。在 LaTeX 中，它读取 PDF 的文本层来找到那个词。Typst 则自己报告位置。

有一条优先规则：按住 ⌘ 点击 PDF 中的超链接时，执行的是链接行为，而不是跳转。

## Typst 项目

Typst 同步需要 Typst 0.13 或更高版本。固定在 Typst 0.11 或 0.12 的项目可以正常编译，但跳转到 PDF 按钮会隐藏，⌘ 点击也没有任何作用。要恢复同步，请在编译菜单中，于 **Typst 版本（本项目）** 下固定一个更新的版本。如果文档的版面很重要，请先[试用较新版本](/docs/typst/#try-a-newer-version-before-switching)。

## 跳转没有反应时

同步数据来自最近一次编译，所以可能过时：

- **自上次构建以来你编辑过。** Oleafly 仍会把未改动的行精确映射，把已编辑的行映射到最近的未改动行，所以大多数跳转依然有效。如果跳转落在错误的位置，请重新编译（⌘↵）后再跳转一次。
- **该行没有可见的输出**（注释、导言区的行、`#set` 规则、空行）。请把光标放在有排版文字的行上。

## 不适用的情况

- [分离的预览窗口](/docs/pdf-preview/#open-preview-in-a-new-window)会镜像 PDF，但不接受 ⌘ 点击。请从主窗口跳转。
- Markdown 项目没有源码与 PDF 同步。
- 图片和图表项目会跳过它，因为一页的图不需要同步。
