【超詳細】別再看零散的教程了！一篇搞定Gitee從注冊、配置到代碼上傳與管理（內含避坑指南最佳實踐）

?🔥個人主頁：艾莉絲努力練劍

?專欄傳送門：《C語言》、《數據結構與算法》、C語言刷題12天IO強訓、LeetCode代碼強化刷題、洛谷刷題、C/C++基礎知識知識強化補充、C/C++干貨分享&學習過程記錄

🍉學習方向：C/C++方向學習者

??人生格言：為天地立心，為生民立命，為往圣繼絕學，為萬世開太平

前言：作為一名開發者，無論是初學者還是資深大佬，代碼版本管理和協作都是我們的核心技能。GitHub雖好，但在國內訪問時而抽風，這時候一個穩定、高速的國內平臺就顯得至關重要——Gitee（碼云）?正是我們的不二之選。

本文將從零開始，手把手帶你完成Gitee的全程使用，內容涵蓋注冊、安裝配置Git、SSH密鑰對接、創建倉庫、代碼上傳、日常管理以及高級技巧。不止步于“怎么做”，更深入講解“為什么這么做”，幫你徹底擺脫依賴圖形化工具卻不懂原理的困境，真正掌握Git核心思想。全文超6000字，建議收藏后慢慢實踐。

第一章：緣起——為什么是Gitee？

1.1? 訪問速度極快

1.2? 全中文環境

1.3? 符合本地需求

1.4? 生態整合

第二章：萬丈高樓平地起——Gitee賬號注冊與準備

第1步：注冊Gitee賬號

第2步：安裝Git

?Windows用戶：

macOS用戶：

Linux用戶 (如Ubuntu/Debian)：

第3步：全局配置Git用戶信息

第三章：建立安全通道——配置SSH公鑰

第1步：生成SSH密鑰對

第2步：將公鑰添加到Gitee

第四章：第一個倉庫——代碼上傳全流程

場景A：本地已有項目，想推送到Gitee

第1步：在Gitee上創建遠程倉庫

第2步：初始化本地倉庫并提交代碼

第3步：關聯遠程倉庫并推送

場景B：從Gitee克隆（Clone）已有項目

第五章：日拱一卒——日常開發工作流

5.1? 標準流程：add?->?commit?->?push

5.2? 重要概念：拉取更新（Pull）！

第六章：錦上添花——高級技巧與最佳實踐

6.1??.gitignore?文件

6.2? 分支（Branch）管理

6.3? 使用Gitee的 Pull Request (PR)

第七章：常見問題與避坑指南（Q&A）

7.1? Q:?git push?提示?Permission denied (publickey)？

7.2? Q:?git push?提示?error: failed to push some refs to...？

7.3? Q: 提交時寫錯了提交信息怎么辦？

7.4? Q: 誤把不該提交的文件（如密碼配置文件）add 了怎么辦？

總結與展望

結尾

第一章：緣起——為什么是Gitee？

在正式開始介紹之前，我們先簡單了解一下為什么推薦Gitee。

1.1? 訪問速度極快

服務器位于國內，無論是克隆、推送還是拉取代碼，速度都比GitHub快數個量級，尤其是在下載大型倉庫或依賴時，體驗提升巨大。

1.2? 全中文環境

界面、文檔、幫助中心均為中文，對國內用戶非常友好，降低了學習和使用門檻。

1.3? 符合本地需求

集成了代碼片段、Wiki、Issue、Pull Request（Gitee中稱為“Pull Request”或“合并請求”）、Pages（Gitee Pages）等功能，同時支持企業版的私有化部署，更貼合國內企業和團隊的工作流程。

1.4? 生態整合

與國內的CI/CD（如Jenkins）、項目管理工具等有較好的集成。

對于個人學習者、初創團隊以及國內企業項目，Gitee提供了一個非常穩定和高效的協作環境。

第二章：萬丈高樓平地起——Gitee賬號注冊與準備

第1步：注冊Gitee賬號

打開Gitee官網：Gitee
點擊頁面右上角的?【注冊】?按鈕。
你可以通過?手機號?或?郵箱?進行注冊。按提示填寫信息即可。建議使用常用郵箱，方便接收重要通知。
注冊完成后，別忘記去郵箱激活賬號。激活后，你的Gitee之旅就正式開始了。

第2步：安裝Git

Gitee是一個Git服務器，我們要在本地操作，必須安裝Git客戶端。

?Windows用戶：

1、訪問 Git 官方下載頁：https://git-scm.com/download/win。

2、下載并運行安裝程序。安裝過程中，一路?“Next”?即可，但有幾個關鍵點需要注意：

（1）選擇組件: 勾選?Git Bash Here?和?Git GUI Here，非常實用。

（2）選擇默認編輯器: 強烈推薦選擇?Use Visual Studio Code as Git's default editor（如果你安裝了VSCode），或者選擇你熟悉的編輯器（如Nano、Vim）。

（3）調整Path環境: 選擇?Git from the command line and also from 3rd-party software。這將允許你在任何命令行（如CMD、PowerShell）中使用Git。

（4）選擇SSH客戶端: 使用默認的?OpenSSH。

（5）配置行結束符轉換: 選擇?Checkout Windows-style, commit Unix-style line endings。這是為了Windows和Unix/Linux系統協作時的兼容性。

（6）終端模擬器: 選擇默認的?Use MinTTY。

（7）其他選項默認即可。

macOS用戶：

（1）最簡單的方法：安裝Xcode Command Line Tools。在終端（Terminal）中運行?xcode-select --install。

（2）或者使用Homebrew：brew install git。

Linux用戶 (如Ubuntu/Debian)：

在終端中運行：sudo apt-get update && sudo apt-get install git安裝驗證：

安裝完成后，打開你的終端（Windows可用Git Bash或CMD/PowerShell），輸入：

git --version

如果正確顯示版本號（如?git version 2.37.1.windows.1），說明安裝成功。

第3步：全局配置Git用戶信息

這是非常重要的一步！你提交的每一次代碼都會帶有這個身份信息，它用于標識提交者。

在終端中執行以下兩條命令，將示例郵箱和用戶名替換成你注冊Gitee時使用的信息：

git config --global user.name "Your-Gitee-Username"
git config --global user.email "your-email@gitee.com"

說明：

（1）——global表示這是全局配置，對你這臺電腦上所有的Git倉庫生效。如果某個項目想用不同的信息，可以在項目目錄下不加?--global?再配置一次；

（2）user.name?建議和Gitee用戶名保持一致，避免混淆；

（3）user.email?必須是你在Gitee上注冊時使用的郵箱，否則你的提交貢獻將無法在Gitee上正確統計。檢查配置是否成。

git config --global --list

第三章：建立安全通道——配置SSH公鑰

為了避免每次推送代碼都輸入賬號密碼，我們需要配置SSH密鑰，實現免密安全登錄。這是最佳實踐，務必掌握。

第1步：生成SSH密鑰對

?1、打開終端（Git Bash）。

?2、運行以下命令，將?your-email@example.com?替換為你的Gitee郵箱：

ssh-keygen -t ed25519 -C "your-email@example.com"

?注：如果你的系統不支持?ed25519?算法，可以使用舊的RSA算法：ssh-keygen -t rsa -b 4096 -C "your-email@example.com"。

?3、接下來會提示你“Enter file in which to save the key”，直接按回車，使用默認的保存路徑（~/.ssh/id_ed25519?或?~/.ssh/id_rsa）。

?4、會提示你輸入一個密碼（passphrase），可以直接回車留空（方便使用），當然為了安全起見，設置一個密碼更好。之后推送時可能需要輸入這個密碼。

第2步：將公鑰添加到Gitee

?1、根據你上一步選擇的算法，在終端中用以下命令打印出公鑰內容：

（1）如果是?ed25519:?cat ~/.ssh/id_ed25519.pub；

（2）如果是?rsa:?cat ~/.ssh/id_rsa.pub。

?2、終端會顯示一長串以?ssh-ed25519?或?ssh-rsa?開頭，以你的郵箱結尾的文本。完整地復制它。

?3、登錄Gitee，點擊右上角頭像 ->?【設置】。

?4、進入左側菜單的?【SSH公鑰】。

?5、在“添加公鑰”頁面：

（1）標題: 給你的公鑰起個名字，比如?My Work Laptop。

（2）公鑰:?粘貼你剛才復制的完整公鑰內容。

?6、點擊?【確定】，可能需要驗證一下密碼。

第3步：驗證是否配置成功

在終端輸入：

ssh -T git@gitee.com

第一次連接時，會提示你是否信任主機，輸入?yes?回車。
如果配置成功，你會看到一條如下的歡迎信息

Hi USERNAME! You've successfully authenticated, but Gitee.com does not provide shell access.

這表明你的SSH通道已經成功建立！

第四章：第一個倉庫——代碼上傳全流程

現在我們開始實戰，將本地代碼推送到Gitee。

場景A：本地已有項目，想推送到Gitee

第1步：在Gitee上創建遠程倉庫

?1、登錄Gitee，點擊右上角 +?號，選擇?【新建倉庫】。

?2、填寫倉庫信息：

（1）倉庫名稱：必填，如?my-awesome-project。

（2）路徑：會自動生成，通常和倉庫名一致，這是你倉庫的URL的一部分。

（3）介紹：可選，簡單描述你的項目。

（4）公開/私有：選擇倉庫的可見性。私有倉庫只有你授權的人才能看到。

（5）初始化倉庫：不要勾選?使用Readme文件初始化這個倉庫。因為我們本地已有項目，如果勾選，會導致后續推送沖突，需要先拉取合并，對新手不友好。我們從一個空的倉庫開始。

（6）選擇.gitignore?和?許可證：可以根據你的項目類型選擇，也可以后續手動添加。

?3、點擊?【創建】。

第2步：初始化本地倉庫并提交代碼

?1、打開終端，進入到你的本地項目根目錄。

?2、執行以下命令，初始化一個本地Git倉：

git init

這會在當前目錄創建一個?.git?的隱藏文件夾。

3、將當前目錄下的所有文件（除了在?.gitignore?中聲明的）添加到暫存區（Stage）：

git add .

git add .?中的?.?代表當前目錄。你也可以用?git add filename?添加特定文件。

4、將暫存區的文件提交（Commit）?到本地倉庫，并附上提交信息：

git commit -m "first commit: init project"

-m?后面的字符串是本次提交的說明，必須填寫，且應清晰有意義。

第3步：關聯遠程倉庫并推送

?1、將你在Gitee上創建的空倉庫的地址關聯到本地倉庫。

（1）在Gitee你的空倉庫頁面，點擊?【克隆/下載】?按鈕，選擇?SSH，復制地址（如?git@gitee.com:your-username/your-repo-name.git）。

?2、在終端中，為本地倉庫添加一個名為?origin?的遠程地址（這是慣例，代表主倉庫：

git remote add origin git@gitee.com:your-username/your-repo-name.git

使用?git remote -v?可以查看是否添加成功。

?3、首次推送，使用?-u?參數將本地的?master?分支（現在主流更推薦?main，但Git默認初始化可能是?master）推送到遠程的?origin?倉庫，并建立關聯：

git push -u origin master
# 或者，如果你的默認分支是 main
# git push -u origin main

-u?(或?--set-upstream) 選項會記住這次推送的分支和目標，下次在這個分支只需要輸入?git push?即可。

恭喜！?刷新你的Gitee倉庫頁面，代碼已經全部安靜地躺在那里了。

場景B：從Gitee克隆（Clone）已有項目

如果你要參與別人的項目，或者在公司電腦上繼續開發家里電腦上傳的項目，你需要克隆。

?1、在Gitee上找到你要克隆的項目倉庫頁面。

?2、點擊?【克隆/下載】，復制SSH地址（如?git@gitee.com:username/repo.git）。

?3、在終端中，切換到你想存放項目的目錄，運行：

git clone git@gitee.com:username/repo.git

4、Git會自動為你完成以下操作：

（1）在當前目錄下創建一個以倉庫名命名的文件夾。

（2）初始化本地倉庫。

（3）關聯遠程倉庫，默認名稱就是?origin。

（4）拉取（Pull）遠程?origin?的所有數據（默認分支）。

5、進入項目目錄 (cd repo)，你就可以開始開發了。

第五章：日拱一卒——日常開發工作流

你不會只提交一次代碼。日常開發是不斷循環以下步驟：

5.1? 標準流程：`add`?->?`commit`?->?`push`

1、修改代碼：完成一個小功能或修復一個bug。

2、查看狀態：使用?git status?查看哪些文件被修改、哪些已暫存。

3、添加到暫存區：git add .?或?git add specific_file.js。

4、提交到本地倉庫：git commit -m "feat: add user login function"。提交信息要規范，推薦使用?約定式提交?規范，如?fix:,?feat:,?docs:?等開頭。

5、推送到遠程：git push。因為第一次推送時用了?-u，所以這里直接?git push?就行。

5.2? 重要概念：拉取更新（Pull）！

在團隊協作中，遠程倉庫可能已經被隊友更新了。所以在你的?git push?之前，務必先拉取一下遠程的最新更改，并合并到本地，避免沖突。

git pull origin master
# 等同于 git fetch + git merge
# 如果默認分支是main，則替換為main

如果?git pull?后存在沖突，Git會提示你，你需要手動解決沖突文件中的差異（文件中的?<<<<<<<,?=======,?>>>>>>>?標記），然后再次?add,?commit,?push。

第六章：錦上添花——高級技巧與最佳實踐

6.1??`.gitignore`?文件

這個文件告訴Git哪些文件或目錄不需要納入版本控制。比如IDE配置文件（.idea/,?.vscode/）、依賴文件夾（node_modules/）、日志文件、編譯產物等。

最佳實踐：項目一開始就創建它。你可以在?gitignore.io - Create Useful .gitignore Files For Your Project?生成對應語言或工具的?.gitignore?模板。

6.2? 分支（Branch）管理

在主分支（master/main）上直接開發是危險的。應該為每個新功能或bug修復創建一個新分支。

# 創建并切換到新功能分支
git checkout -b feature/awesome-new-feature# 在新分支上開發、提交...
git add .
git commit -m "feat: implement awesome feature A"# 開發完成后，切換回主分支
git checkout main# 確保主分支是最新的
git pull origin main# 將功能分支合并到主分支
git merge feature/awesome-new-feature# 刪除已合并的本地功能分支
git branch -d feature/awesome-new-feature# 推送更新后的主分支
git push origin main

6.3? 使用Gitee的 Pull Request (PR)

如果你在** Fork **的倉庫上開發（參與開源項目），或者公司的代碼審查流程要求，你不會直接合并到主分支，而是發起一個?Pull Request（合并請求）。

1、將你的功能分支推送到你的遠程倉庫：git push origin feature/xxx。

2、在Gitee倉庫頁面，通常會自動彈出創建PR的提示，或者你手動點擊?【Pull Requests】?->?【新建 Pull Request】。

3、選擇你的功能分支作為源分支，目標分支為主分支。

4、填寫標題和描述，請求代碼審查。

5、審查通過后，由項目管理員合并你的PR。

第七章：常見問題與避坑指南（Q&A）

7.1? Q:?`git push`?提示?`Permission denied (publickey)`？

A：SSH密鑰配置失敗。請重新檢查第三章的所有步驟：密鑰是否生成、公鑰是否完整復制到Gitee、是否驗證成功。

7.2? Q:?`git push`?提示?`error: failed to push some refs to...`？

A：通常是因為遠程倉庫有你本地沒有的更新（比如你在網頁上創建了README文件）。先執行?git pull origin master --rebase，拉取遠程更新并變基，解決可能的沖突后，再?git push。

7.3? Q: 提交時寫錯了提交信息怎么辦？

A：如果還沒推送到遠程，使用?git commit --amend?命令可以修改上一次的提交信息。

7.4? Q: 誤把不該提交的文件（如密碼配置文件）add 了怎么辦？

A：如果還沒commit，用?git reset HEAD <file>?將其從暫存區撤出。如果已經commit了，需要使用?git filter-branch?或?BFG Repo-Cleaner?等工具從歷史中徹底刪除，這操作很危險，建議查專門教程。

總結與展望

至此，你已經系統地掌握了Gitee的核心使用流程：

1、環境準備：注冊 + 安裝Git + 配置用戶信息。

2、安全通道：生成并配置SSH密鑰，實現免密操作。

3、核心操作：

（1）git init,?git add,?git commit,?git push?(本地到遠程)；

（2）git clone,?git pull?(遠程到本地)

4、進階知識：.gitignore、分支、Pull Request。