萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

TortoiseGit 配合 Git@OSC(Gitee)完整圖文教程:從金鑰生成到推送代碼

前置準備

步驟 1:生成 SSH 金鑰對

  1. 執行 puttygen.exe,點選 Generate,滑動滑鼠產生隨機性。
  2. 生成完成後,分別點選 Save public key(如 id_rsa.pub)與 Save private key(如 id_rsa.ppk)。
  3. 複製公鑰內容(以 ssh-rsa 開頭的整串字串)。

步驟 2:於 Gitee 添加公鑰

  1. 進入 https://gitee.com/profile/sshkeys(或右上角頭像 → 設定 → SSH 公鑰)。
  2. 點選 添加公鑰,貼上剛複製的公鑰,設定標題(如 "My Laptop"),確認。

步驟 3:建立本地倉庫並關聯遠端

  1. 在本地選擇一個空目錄,右鍵 → Git Create repository here,不要勾選 "Make it Bare"。
  2. 右鍵目錄 → TortoiseGit → Settings → Remote:
    Remote 填 origin,URL 貼上 Gitee 專案的 SSH 地址(格式:git@gitee.com:username/repo.git),Putty Key 選擇步驟 1 產生的 .ppk 私鑰檔。點選 Add New/Save。

步驟 4:拉取、提交、推送

  1. 右鍵目錄 → TortoiseGit → Pull,確認遠端分支(通常為 master),點選 OK 將遠端代碼拉取到本地。
  2. 修改或新增檔案後,右鍵 → Git Commit → "master",填寫提交訊息,點選 Commit。
  3. 右鍵 → TortoiseGit → Push,確認遠端與分支,點選 OK 完成推送。

常見問題

  • Permission denied (publickey):確認 .ppk 路徑正確、公鑰已加入 Gitee、SSH Agent 未衝突。
  • 無法連線:檢查防火牆/代理,嘗試 ssh -T git@gitee.com 測試連通性。

掌握以上流程,即可在 Windows 上以圖形化方式高效管理 Gitee 專案。

copyright © 萬盛學電腦網 all rights reserved