將 GitHub 連接到 Notion
將提取要求與您團隊的專案計畫一起保留在 Notion 中。
受管理的 GitHub 同步功能會將您選取的 GitHub 工作匯入 Notion：提取要求、問題或兩者皆有。Notion 會匯入您現有的記錄，並在背景檢查 GitHub 的更新。
本指南涵蓋您 GitHub 連接設定中的 同步資料庫。同步的屬性為唯讀。請在 GitHub 中變更提取要求與問題。
注意： 此 GitHub 整合功能將取代我們舊有的 版本。為了讓您的外部資料保持最新，請於 2026 年 10 月 30 日前設定新的同步。您現有的同步資料庫將保留在 Notion 中，但在該日期之後將停止更新。
如果您使用舊版同步功能匯入問題，您也可以使用此版本同步問題。
選擇要從透過 GitHub App 安裝所提供的儲存庫中匯入 Notion 的內容：提取要求、問題或兩者皆有。您選取的儲存庫會反映到 Notion 的動態中。
資訊 | 屬性 |
|---|---|
提取要求 | 標題、PR 編號、GitHub URL、儲存庫 |
州 | 狀態：未解決、草稿、已合併或已關閉 |
作者 | 作者 (GitHub)，以及當找到相符的 Notion 成員時的作者 |
組織 | 標籤、基礎分支、頭部分支 |
日期 | 建立時間、更新時間、關閉時間、合併時間 |
作者 (GitHub) 屬性包含 GitHub 使用者名稱。作者 是當作者公開的電子郵件與工作空間成員相符時的 Notion 人員屬性。
描述 屬性會將提取要求的描述同步為純文字，並完全按照 GitHub 中的書寫方式複製。它不會呈現為 Markdown。
您可以單獨同步 GitHub 問題，或與提取要求一併同步。此同步不包含提取要求的留言或評論詳細資料。
您需要：
Notion 工作空間的成員資格。
擁有您想要同步之儲存庫存取權限的 GitHub 帳號。
擁有這些儲存庫存取權限的 GitHub App 安裝。
商業版（行動商業版亦適用）。GitHub 同步不適用於其他方案。
您的 GitHub 帳號與應用程式安裝皆需要存取權限。您的 GitHub 組織可能需要擁有者核准或安裝該應用程式。
在 Notion 中，前往 設定 → 連接 → GitHub。
開啟 資料庫同步，並連接您的 GitHub 帳號（若尚未連接）。
完成 GitHub 的授權與安裝步驟。
選取您想要同步其儲存庫的組織或帳號。若需要新增其他安裝，請使用 新增組織…。
選取要包含的儲存庫。
為您的同步命名，並選取要匯入 Notion 的內容：提取要求、問題或兩者皆有。
選取所有可用歷史記錄或特定的歷史記錄時間範圍。
選取 建立同步。
Notion 會在您的私人側邊欄中建立同步資料庫，並開始匯入相符的記錄。
提示： 找不到儲存庫嗎？請使用 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 →
