新增到遠端倉庫

開源專案託管平台簡介

• GitHub：全球最大的開源平台，適合開源項目及個人專案。提供豐富的社群互動功能（如 Issues、Pull Requests）。
• GitLab：支援私有倉庫、CI/CD 功能較強，企業用戶常用。
• Gitee：國產的開源託管平台，純中文介面，適合國內開發者使用。

GitHub 的常見操作

1. 關注與點讚：對喜愛的專案點讚、關注，保持專案更新通知。
2. Pull Request（PR）：貢獻代碼，發送 PR 請求專案作者合併更改。
3. Issues：向專案作者報告問題、提出建議，便於追蹤需求和 Bug。
4. Fork：複製他人專案到自己的帳戶，便於修改和實驗。
5. 創建開源專案：自行創建公開倉庫，讓全球開發者參與協作。

步驟 1：在 GitHub 上創建遠端倉庫

1. 登入 GitHub。
2. 點選「New repository」創建一個新倉庫。
3. 填寫倉庫名稱（例如 myproject），選擇「Public」（公開）或「Private」（私有），然後點擊「Create repository」。

步驟 2：連接本地倉庫到 GitHub 倉庫

1. 開啟終端機並進入本地 Git 專案目錄。
2. 將本地倉庫連接至 GitHub 遠端倉庫。用 GitHub 倉庫的 URL 替換 <遠端倉庫URL>。
   • 指令：
     git remote add origin <遠端倉庫URL>

3. 確認連接是否成功：
   git remote -v

步驟 3：將本地程式碼推送到 GitHub

1. 首次推送專案內容到遠端倉庫時，請使用 -u 參數設定上游分支，以便後續的同步操作。
   • 指令：
     git push -u origin main

2. 推送完成後，本地倉庫的程式碼就會同步到 GitHub 遠端倉庫，其他開發者可以通過克隆該倉庫來協作開發。

使用 SSH 將本地倉庫推送至 GitHub 的設置流程

GitHub 支援 HTTPS 和 SSH 兩種同步方式。雖然 HTTPS 更簡便，但 SSH 在多次提交中更加高效，無需重複輸入帳號和密碼。以下是 SSH 的設置步驟：

步驟 1：生成 SSH 金鑰

1. 打開終端機並檢查是否已有 SSH 金鑰：
   ls -al ~/.ssh


   如果已有 id_rsa 和 id_rsa.pub 檔案，可以跳過生成金鑰的步驟，直接進行配置。

2. 若沒有 SSH 金鑰，執行以下命令來生成一組新的金鑰對：
   ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

   • -t rsa 指定金鑰類型為 RSA。
   • -b 4096 表示金鑰長度為 4096 位元。
   • -C 後接上您的 GitHub 電子郵件地址。
3. 根據提示，選擇金鑰存放位置（一般使用預設路徑 ~/.ssh/id_rsa），並設置密碼（可以留空）。

步驟 2：將 SSH 公鑰添加至 GitHub

1. 獲取生成的公鑰內容：
   cat ~/.ssh/id_rsa.pub


   複製顯示的公鑰內容。

2. 登入 GitHub，進入 Settings > SSH and GPG keys，點選「New SSH key」按鈕。
3. 將公鑰粘貼至「Key」欄位，並為該金鑰設置名稱（如「My Computer」）。點選「Add SSH key」完成添加。

步驟 3：測試 SSH 連接

1. 在終端機中執行以下命令，以確認 GitHub 的 SSH 連接正常：
   ssh -T git@github.com

2. 如果配置成功，會看到如下訊息：
   Hi username! You've successfully authenticated, but GitHub does not provide shell access.

步驟 4：將本地倉庫推送至 GitHub 遠端倉庫

1. 在本地專案目錄中設置遠端倉庫的 SSH URL（用 GitHub 提供的 SSH URL 替代 <SSH URL>）：
   git remote add origin <SSH URL>

2. 推送本地倉庫至 GitHub：
   git push -u origin main


   使用 -u 參數設定上游分支，便於後續的同步操作。

注意事項

• SSH 設置只需一次：一旦配置成功，後續的提交和拉取操作都無需再輸入帳號和密碼。
• 切換方式：若要切換回 HTTPS，只需更改遠端倉庫的 URL：
  git remote set-url origin <HTTPS URL>