前置準備
步驟 1:生成 SSH 金鑰對
- 執行
puttygen.exe,點選 Generate,滑動滑鼠產生隨機性。
- 生成完成後,分別點選 Save public key(如
id_rsa.pub)與 Save private key(如 id_rsa.ppk)。
- 複製公鑰內容(以
ssh-rsa 開頭的整串字串)。
步驟 2:於 Gitee 添加公鑰
- 進入
https://gitee.com/profile/sshkeys(或右上角頭像 → 設定 → SSH 公鑰)。
- 點選 添加公鑰,貼上剛複製的公鑰,設定標題(如 "My Laptop"),確認。
步驟 3:建立本地倉庫並關聯遠端
- 在本地選擇一個空目錄,右鍵 → Git Create repository here,不要勾選 "Make it Bare"。
- 右鍵目錄 → TortoiseGit → Settings → Remote:
Remote 填 origin,URL 貼上 Gitee 專案的 SSH 地址(格式:git@gitee.com:username/repo.git),Putty Key 選擇步驟 1 產生的 .ppk 私鑰檔。點選 Add New/Save。
步驟 4:拉取、提交、推送
- 右鍵目錄 → TortoiseGit → Pull,確認遠端分支(通常為
master),點選 OK 將遠端代碼拉取到本地。
- 修改或新增檔案後,右鍵 → Git Commit → "master",填寫提交訊息,點選 Commit。
- 右鍵 → TortoiseGit → Push,確認遠端與分支,點選 OK 完成推送。
常見問題
- Permission denied (publickey):確認
.ppk 路徑正確、公鑰已加入 Gitee、SSH Agent 未衝突。
- 無法連線:檢查防火牆/代理,嘗試
ssh -T git@gitee.com 測試連通性。
掌握以上流程,即可在 Windows 上以圖形化方式高效管理 Gitee 專案。