什麼是 GitHub？

  • 8 分鐘

在此單元中，我們會檢閱下列學習目標：

  • GitHub Enterprise 平台的簡短概觀
  • 如何建立存放庫
  • 將檔案新增至存放庫
  • 如何搜尋存放庫
  • Gist 和 Wiki 簡介

GitHub

在我們詳細探索 GitHub 平台之前，了解它的構建內容非常重要：Git。

Git 是一個分散式版本控制系統，可讓開發人員追蹤變更、協作處理程式碼以及管理一段時間內的修訂。 GitHub 建立在 Git 之上，添加了協作工具、自動化功能和用戶友好的 Web 介面。 了解 Git 基礎知識（例如提交、分支和合併）將幫助您更有效地使用 GitHub。

GitHub Platform 的概念影像，其中包含從上到下的圖層:AI、共同作業、生產力、安全性和規模。

GitHub 是雲端式平台，其核心是使用 Git (分散式版本控制系統)。 GitHub 平台可簡化在專案的共同作業程序，並提供網站、命令列工具以及整體程序，以便開發人員與使用者共同作業。

如我們先前所了解，GitHub 提供 AI 支援的開發人員平台以建置、調整及交付安全的軟體。 讓我們細分 GitHub Enterprise 平台、AI、共同作業、生產力、安全性和規模的每個核心要素。

AI

生成式 AI 正在極大地改變軟體開發。 GitHub Enterprise 平台透過 AI 驅動的提取請求和問題增強 協作 ，透過 Copilot、 Copilot Chat 和 Copilot 代理程式提高生產力，並透過提供更快的回饋來提高安全性。

共同作業

共同作業是 GitHub 所做一切的核心。 GitHub 提供的工具可幫助團隊高效協作、減少延遲並簡化工作流程。

存放庫、問題、提取請求和其他工具有助於支援跨角色更快的協作、縮短審批週期並提高交付速度。

生產力

使用 GitHub Enterprise 平台提供的自動化功能來加速生產力。 通過直接集成到開發過程中的內置 CI/CD（持續集成和持續交付）工具，該平台允許用戶自動執行重複性任務並加快日常工作。 這使得開發人員能夠更專注於編碼和解決問題。

安全性

GitHub 從一開始和每個階段就將安全性直接整合到開發流程中。 GitHub Enterprise 包含原生第一方功能，例如 CodeQL、 秘密掃描、 Dependabot 和 安全性概觀 ，以將風險降到最低。 程式碼保持私密，同時仍受益於整合的安全檢查。

GitHub 繼續投資於企業級安全性和合規性。 GitHub 受到 Microsoft 和高度監管行業組織的信賴，遵守全球合規性標準，使其成為大規模安全開發的可靠選擇。

調整

GitHub 是同類中最大的開發人員社群，擁有來自超過 1 億開發人員、420,000,000,000 個儲存庫和無數部署的即時資料。 GitHub 不斷學習和發展其產品。 其龐大的用戶群為開發人員的需求提供了多樣化的視角，推動持續創新以滿足這些需求。 同時，GitHub 是一個可擴展的平台——來自世界各地的開源開發人員為使 GitHub 與眾不同的功能做出了貢獻並增強了這些功能。

這已經轉化為一個令人難以置信的規模，這是地球上任何其他公司都無法比擬的。 來自這個龐大開發人員基礎的見解有助於 GitHub 不斷發展平台。

基本上，GitHub Enterprise Platform 著重於開發人員體驗。 它提供協作工具、自動化和 AI 驅動的功能，在統一的開發人員體驗中支持生產力、安全性和可擴展性。

現在讓我們進入 GitHub 的骨幹 (也就是存放庫)。

存放庫簡介

讓我們先檢閱：

  • 什麼是存放庫？
  • 如何建立存放庫
  • 將檔案新增至存放庫
  • 如何搜尋存放庫
  • gist、wiki 和 GitHub 頁面簡介

什麼是存放庫？

存放庫包含您專案的所有檔案和每個檔案的修訂歷程記錄。 它是協助您與人們共同作業的重要部分之一。 您可以使用存放庫來管理您的工作、追蹤變更、儲存修訂歷程記錄，並與其他人合作。 在深入探討之前，讓我們先從如何建立存放庫開始。

如何建立存放庫

您可以在個人帳戶或任何您具有足夠權限的組織上建立新的存放庫。

讓我們逐步解說如何從 github.com 建立儲存庫。

  1. 在任何頁面的右上角，使用下拉式功能表並選取 [新增存放庫]。

    GitHub.com 右上角中的加號之下拉式功能表的螢幕擷取畫面，其中第一個選項是 [新存放庫]。

  2. 使用 [擁有者] 下拉功能表來選取您希望擁有存放庫的帳戶。

    應為新存放庫擁有者之人員的下拉式功能表螢幕擷取畫面。

  3. 輸入存放庫的名稱，以及選擇性描述。

    醒目提示存放庫名稱的文字方塊的影像。

  4. 選擇存放庫可見度。

    • 公用存放庫可供網際網路上的所有人存取。

    • 私人存放庫只能由您、您明確共用存取權的人員，以及特定組織成員 (針對組織存放庫) 存取。

  5. 選取 [建立存放庫] 並且恭喜！ 您剛建立了存放庫！

如何複製儲存庫

複製儲存庫可讓您在電腦上建立儲存庫的本機副本。 這對於在本機進行變更並將其同步回遠端儲存庫非常有用。

  1. 在 GitHub.com 上，導覽至您要複製之存放庫的主頁面。

  2. 在檔案清單上方，按一下 程式碼 按鈕。

    帶有克隆選項的代碼按鈕下拉菜單的屏幕截圖。

  3. 使用 HTTPS、SSH 或 GitHub CLI 選項複製儲存庫的 URL。

  4. 開啟終端機並導航到要複製儲存庫的目錄。

  5. 執行下列命令，並取代 <repository-url> 為您複製的 URL：

    git clone <repository-url>

  6. 複製過程完成後，導航到存儲庫文件夾：

    cd <repository-name>

祝賀！ 您現在擁有儲存庫的本機副本。

接下來，讓我們檢閱如何將檔案新增至您的存放庫。

如何將檔案新增至存放庫

GitHub 中的檔案可以做一些事情，但檔案的主要用途是儲存專案的相關資料和資訊。 若要將檔案新增至存放庫，您至少需要 寫入 存取權。

讓我們檢閱如何將檔案新增至您的存放庫。

  1. 在 GitHub.com 上，瀏覽至存放庫的主頁面。

  2. 在您的存放庫中，透過選取 [建立新檔案] 連結或 [上傳現有檔案]，瀏覽至您要在其中建立檔案的資料夾。

  3. 新增後，請在檔案清單上方選取 [新增檔案 ᐁ] 下拉式功能表。 然後選取 [建立新檔案]。

    將檔案新增至您的新存放庫的選項的螢幕擷取畫面，其中以紅色醒目提示，[新增檔案] 按鈕位於畫面右側。

  4. 在檔案名稱欄位中，鍵入範本的名稱與副檔名。 若要建立子目錄，請輸入 / 目錄分隔符號。

  5. 在 [檔案內容] 文字輸入框中，輸入檔案的內容。

  6. 若要檢閱新內容，請選取檔案內容上方的 [預覽]。

    顯示 yml 檔案的螢幕擷取畫面，其中醒目提示左上方的預覽按鈕。

  7. 選取 [認可變更]。

  8. 在 [認可訊息] 欄位中，輸入簡短且有意義的認可訊息，描述您對檔案所做的變更。 您可以將認可歸因於認可訊息中一個以上的作者。

  9. 如果您有多個電子郵件地址與您在 GitHub.com 上的帳戶相關聯，請選取電子郵件地址下拉式功能表。 然後選取要用作 Git 作者電子郵件地址的電子郵件地址。 只有已驗證的電子郵件地址會出現在此下拉式功能表中。 如果您啟用了電子郵件地址隱私權，則 [username]@users.noreply.github.com 是預設的認可作者電子郵件地址。

    顯示提交更改，其中包含描述方塊和電子郵件下拉式功能表，用於選取作為提交的作者之螢幕擷取畫面。

  10. 在 [認可訊息] 欄位下方，決定要將認可新增至目前分支還是新的分支。 如果目前分支是預設分支，您應該選擇為認可建立新的分支，然後建立提取要求。

    顯示從提交選項建立新分支的螢幕擷取畫面，其中選取其下方新分支的文字方塊。

  11. 選取 [認可變更] 或 [建議變更]。

恭喜，您剛在存放庫中建立了新檔案！ 您也已建立新的分支並進行認可。

在我們檢閱下一個單元中的分支和認可之前，讓我們快速檢閱 gist、wiki 和 GitHub 頁面，因為它們與存放庫類似。

什麼是要點？

Gist 是 GitHub 的一項功能，可讓使用者以輕量級且方便的方式共享程式碼片段、註釋或其他小訊息。 它們本質上是迷你 Git 儲存庫，這意味著您可以像完整儲存庫一樣分叉、複製和版本控制它們。 Gist 對於共享快速解決方案、設定檔或範例特別有用，而無需建立完整的儲存庫。

Gists 的主要特點：

  1. 公開和秘密要點：

    • 公開 Gists：這些對每個人都可見，並且可以透過 GitHub 的搜尋功能找到。 它們非常適合分享您想要提供給更廣泛社群的程式碼片段或解決方案。
    • 秘密要點：這些不可搜索或公開列出，但它們並非完全私密。 任何知道 URL 的人都可以存取它們。 它們對於與有限的受眾（例如協作者或朋友）共享程式碼非常有用。

  2. 版本控制：

    • 對 gist 所做的每個更改都會被跟踪，允許您查看編輯歷史記錄。 這樣可以輕鬆恢復到以前的版本或查看程式碼片段如何隨時間演變。

  3. 分支和複製:

    • 與儲存庫一樣，gist 可以分叉和克隆。 這允許其他人在您的工作的基礎上進行擴展或根據他們的需求進行調整。

  4. 嵌入：

    • Gist 可以嵌入到網站或部落格中，使其成為在教學或文件中分享程式碼範例的絕佳工具。

  5. Markdown 支援：

    • Gist 支援 Markdown 格式，這意味著您可以在程式碼旁邊包含富文本、標題、連結甚至圖像。 這對於向片段添加上下文或解釋特別有用。

  6. Collaboration:

    • 雖然 gist 通常用於單個片段，但它們也可以由多個用戶共享和協作。 對 gist 進行分叉和評論可實現輕量級協作。

Gists 的用例：

  • 分享快速程式碼範例或解決方案。
  • 儲存設定檔或腳本供個人使用。
  • 建立常用程式碼模式的範本。
  • 與他人共用錯誤日誌或偵錯資訊。
  • 在部落格、論壇或文件中嵌入程式碼片段。

[!重要]

切勿使用 gist 來儲存敏感或機密資料，例如密碼、機密或 API 金鑰，即使是在指令碼或設定檔中也是如此。
要點並不是完全私密的：即使是秘密要點也可以被任何知道連結的人存取。 在分享之前，請務必仔細檢查您的內容。

要點的局限性：

  • 要點並非完全私密，即使標記為秘密。 任何知道 URL 的人都可以存取它們，因此它們不應用於敏感或機密資訊。
  • 它們最適合小片段或單一檔案。 對於較大的專案或多檔案結構，完整儲存庫更合適。

若要深入瞭解如何建立和管理 Gist，請參閱本課程單元「資源」區段中的 GitHub 文件，或瀏覽 GitHub Gist 文件。

分叉和克隆 Gist

您可以分叉 gist，以在您的帳戶中建立其他人 gist 的副本。

  1. 導航到您要分叉的要點。
  2. 選取 [ 分支 ] 在 gist 頁面的右上角。

若要在本機複製 gist：

git clone https://gist.github.com/your-gist-id.git

若要深入了解 Gist，請參閱本單元 (標題為「建立 Gist」) 結尾的「資源」一節中連結的文章。

什麼是 wiki？

GitHub.com 上的每個存放庫都配備了一個區段來裝載文件 (稱為 wiki)。 您可以使用存放庫的 Wiki 來共用專案的相關長篇內容，例如如何使用專案、其設計方式或其核心原則。 雖然 README 檔案可快速告知您的專案可以做什麼，但您可使用 Wiki 來提供其他文件。

值得提醒的是，如果您的存放庫是私人的，只有至少具您存放庫讀取權限的人員才能存取您的 Wiki。

建立、編輯和刪除 Wiki 頁面

您可以使用 GitHub Wiki 來建立和管理專案的檔。

若要建立 Wiki 頁面：

  1. 導覽至存放庫。
  2. 選取 Wiki 索引標籤。
  3. 如果沒有頁面存在，請選取 建立第一頁， 或 選取 新增頁面 以 新增頁面。
  4. 輸入標題和內容，然後選取 儲存頁面。

若要編輯 Wiki 頁面：

  1. 導覽至您要編輯的 Wiki 頁面。
  2. 選取右上角的 編輯 。
  3. 進行變更並選取 儲存頁面。

若要刪除 Wiki 頁面：

  • 刪除 wiki 頁面需要使用 Git。 複製 wiki 存放庫、移除檔案，然後推送變更。

深入瞭解如何在 GitHub Docs 中管理 Wiki - 新增或編輯 Wiki 頁面。

什麼是功能預覽？

功能預覽可讓您在正式發行之前在 GitHub 上試用實驗性功能。 這些預覽可讓您儘早存取新功能，並允許您提供意見反應以協助塑造最終產品。

若要啟用或停用功能預覽：

  1. 選擇 GitHub.com 右上角的個人資料圖片，導航到您的 GitHub 帳戶。
  2. 從下拉式功能表中選取 功能預覽 。
  3. 瀏覽可用預覽清單並切換您要嘗試的功能。

功能預覽是保持領先地位並探索可以增強 GitHub 體驗的新工具的好方法。

小提示

GitHub 經常添加新的實驗性功能供用戶探索，因此請密切注意 功能評論 以發現新的工具和增強功能。