跳轉到主要內容
將專案連接至 GitHub 儲存庫。變更會雙向同步,而且只會在您點選 Sync 時進行:不會自動同步任何內容。
如果您在 Account settings 或編輯器中看不到 GitHub 選項,請要求管理員啟用 GitHub 同步。
這只需要做一次。
1

開啟帳號設定

點選 Account,然後點選 Account settings。捲動至 GitHub,點選 Link。
帳號設定中的 GitHub 區段,含有 Link 按鈕

帳號設定中的 GitHub

2

在 GitHub 上授權

GitHub 會開啟。如有要求請登入,然後授權該應用程式。
3

檢查連結

您會回到帳號設定,按鈕現在顯示為 Unlink。
帳號設定中的 GitHub 區段,含有 Unlink 按鈕

您的 GitHub 帳號已連結

如果您的帳號尚未連結,Import from GitHub 與編輯器中的 GitHub 卡片會先要求您連結帳號。點選 Link to your GitHub account。您同樣會進入帳號設定,如果是從編輯器開始,則會在新分頁中開啟。然後返回並重新開始。
含有 Link to your GitHub account 按鈕的 Import from GitHub 對話方塊

帳號未連結時的提示

匯入儲存庫

這會從 GitHub 儲存庫建立新專案,並且已與該儲存庫連結。
1

開啟匯入對話方塊

在專案頁面中,點選 New project,然後點選 Import from GitHub。
含有 Import from GitHub 的 New project 選單

New project 選單

擁有專案後才會出現 New project。歡迎頁面上的 Create a new project 選單沒有匯入功能,因此請先建立一個空白專案。
2

選擇儲存庫

點選儲存庫旁的 Import to Overleaf。清單包含您的儲存庫以及您所屬組織的儲存庫。
列出四個儲存庫的 Import from GitHub 對話方塊

您的 GitHub 儲存庫

如果缺少某個組織的儲存庫,請點選 Can’t see what you’re looking for?,查看 GitHub 關於為該組織核准應用程式的說明。
3

檢查專案

新專案會開啟,並包含儲存庫中的檔案。
編輯器顯示匯入的專案及其檔案與編譯後的 PDF

匯入的專案

將專案匯出至新的儲存庫

這會從您擁有的專案建立儲存庫,並將兩者連結。專案只能透過這種方式或匯入來連結:您無法將它連結至已存在的儲存庫。
1

在編輯器中開啟 GitHub

開啟專案。在左側欄中點選 Integrations,然後點選 GitHub。
含有 GitHub 卡片的 Integrations 面板

Integrations 面板

2

填寫儲存庫資訊

選擇 Owner,可以是您自己,也可以是您所屬的某個組織。Repository Name 預設為專案名稱。描述為選填,Private 預設為已選取。點選 Create a GitHub repository。
已填寫的 Export Project to GitHub 表單

Export Project to GitHub

3

檢查連結

對話方塊現在顯示 This project is linked to 以及儲存庫名稱。
匯出後的 Sync with GitHub 對話方塊

專案已連結

同步

1

開啟同步對話方塊

開啟已連結的專案。在左側欄中點選 Integrations,然後點選 GitHub。Recent commits in GitHub 會列出即將進入專案的內容。
列出一個新提交的 Sync with GitHub 對話方塊

GitHub 中有一個新提交在等待

2

描述您的變更

如果您在專案中做了變更,會出現提交訊息欄位。此欄位為選填:如果留空,提交名稱為 Updates from Overleaf。
已填寫提交訊息的 Sync with GitHub 對話方塊

您的變更的提交訊息

3

點選 Sync

點選 Sync。來自 GitHub 的新提交會進入專案,您的變更會推送至儲存庫的預設分支。如果兩邊修改了不同的內容,系統會為您合併。
4

檢查結果

對話方塊顯示 No new commits in GitHub since last merge.,提交訊息欄位也消失了。編輯器中的檔案與 GitHub 上的提交都已是最新狀態。
同步後沒有新提交的 Sync with GitHub 對話方塊

一切皆已同步

如果兩邊修改了相同的行

對話方塊會提示無法合併變更,並指出一個新分支 overleaf-YYYY-MM-DD-HHMMSS,其中保存了您的變更。
含有合併衝突警告的 Sync with GitHub 對話方塊

衝突

  1. 在 GitHub 上或使用 Git 將該分支合併至預設分支。在此期間您可以關閉對話方塊:再次開啟時會顯示相同的訊息。
  2. 點選 I have manually merged. Continue。合併後的結果會進入專案。
  3. 該分支會保留在 GitHub 上。不再需要時請將其刪除。
當您不再希望專案同步時執行此操作。只有專案擁有者可以執行。
1

點選 Unlink

在同步對話方塊中,點選 Unlink。
2

確認

點選 Confirm。關於訂閱的提示不會妨礙您再次連結該專案。
要求確認解除連結的 Sync with GitHub 對話方塊

確認解除連結

3

檢查結果

對話方塊現在顯示 Export Project to GitHub。專案與儲存庫都會保留各自的內容。若要再次同步,請將專案匯出至新的儲存庫,或將儲存庫匯入為新專案。
在 Account settings 的 GitHub 下,點選 Unlink,然後在對話方塊中再次點選 Unlink。
Unlink GitHub Account 對話方塊

解除您的帳號連結

您的專案仍與各自的儲存庫保持連結。在您再次連結帳號之前,無法同步它們。
關於共用專案中誰可以做什麼,請參閱誰可以連結與同步。每位進行同步的協作者都需要連結自己的 GitHub 帳號。
最後修改於 2026年11月20日