將 GitHub 連接到 Notion
將提取要求與您團隊的專案計畫一起保留在 Notion 中。
受管理的 GitHub 同步會從您選取的儲存庫建立一個 GitHub 提取要求 資料庫。Notion 會匯入現有的提取要求，並在背景檢查 GitHub 的更新。
本指南涵蓋您 GitHub 連接設定中的 資料庫同步。同步的屬性為唯讀。請在 GitHub 中對提取要求進行變更。
注意： 此 GitHub 整合功能將取代我們舊有的 版本。為了讓您的外部資料保持最新，請於 2026 年 10 月 30 日前設定新的同步。您現有的同步資料庫將保留在 Notion 中，但在該日期之後將停止更新。
您可以同步透過 GitHub App 安裝所提供之多個儲存庫的提取要求。選取的儲存庫會匯入至同一個 Notion 資料庫。
資訊 | 屬性 |
|---|---|
提取要求 | 標題、PR 編號、GitHub URL、儲存庫 |
州 | 狀態：未解決、草稿、已合併或已關閉 |
作者 | 作者 (GitHub)，以及當找到相符的 Notion 成員時的作者 |
組織 | 標籤、基礎分支、頭部分支 |
日期 | 建立時間、更新時間、關閉時間、合併時間 |
作者 (GitHub) 屬性包含 GitHub 使用者名稱。作者 是當作者公開的電子郵件與工作空間成員相符時的 Notion 人員屬性。
描述 屬性會將提取要求的描述同步為純文字，並完全按照 GitHub 中的書寫方式複製。它不會呈現為 Markdown。
此同步不包含 GitHub 問題、留言、指派對象或評論詳細資訊。
您需要：
Notion 工作空間的成員資格。
擁有您想要同步之儲存庫存取權限的 GitHub 帳號。
擁有這些儲存庫存取權限的 GitHub App 安裝。
商業版（行動商業版亦適用）。GitHub 同步不適用於其他方案。
您的 GitHub 帳號與應用程式安裝皆需要存取權限。您的 GitHub 組織可能需要擁有者核准或安裝該應用程式。
在 Notion 中，前往 設定 → 連接 → GitHub。
開啟 資料庫同步，並連接您的 GitHub 帳號（若尚未連接）。
完成 GitHub 的授權與安裝步驟。
選取您想要同步其儲存庫的組織或帳號。若需要新增其他安裝，請使用 新增組織…。
選取要包含的儲存庫。
選取所有可用歷史記錄或特定的歷史記錄時間範圍。
選取 建立同步。
Notion 會在您的 私人 側邊欄中建立 GitHub 提取要求，並開始匯入相符的提取要求。
提示： 找不到儲存庫嗎？請使用 GitHub 上的「管理存取權限」 來檢查應用程式可以存取哪些儲存庫。如果安裝需要核准，請要求 GitHub 組織擁有者進行核准。
在首次匯入期間，Notion 會從每個選取的儲存庫讀取提取要求，從最近更新的記錄開始，並依序處理選取的歷史記錄。
匯入完成後，Notion 會定期檢查每個儲存庫是否有新的或已更新的提取要求。標籤變更、關閉提取要求或合併等變更，都會更新 Notion 中對應的屬性。
即使關閉 Notion，同步作業仍會持續執行。大型儲存庫、GitHub 請求限制以及暫時性的服務問題可能會延遲更新。請檢查同步狀態以了解進度或錯誤。
選取 所有歷史記錄、過去 30 天、過去 90 天 或 過去 365 天。當提供「同步所有歷史記錄」之切換開關時，請保持開啟 同步所有可用歷史記錄 以包含所有可用的提取要求。
此時間範圍使用提取要求的 更新時間。它不取決於提取要求建立的時間，也不受其狀態為未解決、已關閉或已合併的影響。
例如，一個超過 90 天未變更的未解決提取要求，可能會超出 90 天的時間範圍。
提示：較舊的頁面可以移除。 當提取要求 (pull request) 超出所選的時間範圍時，其頁面將會從同步資料庫中移除，包含您 Notion 屬性中的值。如果您需要保留未變更的提取要求，請使用所有可用的歷史記錄。
在 設定 → 連接 → GitHub → 資料庫同步 中開啟同步設定。
新增儲存庫： 編輯選取項目並選擇 儲存變更。Notion 將會從新增的儲存庫中匯入相符的提取要求。
移除儲存庫： 取消選取它們並儲存。其已同步的提取要求頁面將會從 Notion 中移除。
變更記錄： 較長的視窗會匯入更多歷史記錄。較短的視窗會移除新視窗範圍外的歷史記錄。
暫停更新： 選取 暫停同步。現有的資料與設定將會保留。
恢復更新： 選取 恢復同步 以繼續同步。
在移除儲存庫或縮短歷史記錄之前，請先保留受影響頁面中您所需的任何 Notion 專屬資訊。
依儲存庫、狀態、作者或標籤建立瀏覽模式。新增您自己的屬性來追蹤發布就緒狀態，或將提取要求與團隊的規劃流程連結。您自己的屬性值會保留在 Notion 中。
若要變更 GitHub 屬性，請使用 GitHub URL 開啟提取要求，並在 GitHub 中進行變更。
資料庫預設為私人。若您分享它，Notion 的分享設定將決定誰能瀏覽匯入的資料。瀏覽者不需要個別擁有來源儲存庫的存取權，因此在分享私人儲存庫資訊前，請先檢查資料庫的權限。
我找不到組織或儲存庫
請檢查您是否選取了正確的 GitHub 帳號與應用程式安裝。確認您的帳號與應用程式皆擁有儲存庫存取權限。若組織限制了應用程式安裝，請要求擁有者核准存取權限。
儲存庫已重新命名或移動
開啟同步的儲存庫設定，重新檢視儲存庫選取項目並再次儲存。若它已移動至不同的組織，請確認連接在新位置擁有存取權限。
「作者」屬性為空
GitHub 使用者名稱不一定會有與 Notion 工作空間成員相符的公開電子郵件。當人員屬性為空時，請使用 作者 (GitHub) 來識別作者。對作者電子郵件或工作空間成員資格的變更，可能不會自動重新整理較舊的同步提取要求。
提取要求遺失
確認其儲存庫已選取、其上次更新在記錄視窗內，且您的 Notion 瀏覽模式未將其篩選掉。首次匯入可能仍在執行中。
資料庫已停止更新
開啟同步的狀態詳細資料。若系統提示，請重新連接您的 GitHub 帳號或還原儲存庫存取權限。GitHub 的請求限制與暫時性中斷可能會在 Notion 重試時延遲更新。
如需與 Workers 的比較以及共用的疑難排解指南，請參閱 從其他工具同步資料至 Notion →
