# 原始碼與 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 同步。
- 圖片和圖表專案不使用它，因為單頁的圖不需要。
