不會碼雲Gitee怎樣實戰使用？看完這教程你就知道了

學習時，經常需要管理自己的代碼，使用到碼雲gitee 這個代碼託管平臺，所以在這裏操作演示，做個筆跡詳細記錄一下。以下介紹 gitee 的使用操作。

Gitee實戰教程目錄

一、碼雲Gitee相關介紹

二、 Gitee註冊賬號和搭建環境

2.1 初次運行前的配置

三、創建Gitee倉庫和提交代碼

四、分支與標籤的管理

五、常用命令

六、操作時遇到的問題

一、碼雲Gitee相關介紹

簡介：介紹碼雲gitee的相關信息。

1.1 碼雲的介紹

碼雲是現在國內最大的代碼託管平臺，提供基於Git的代碼託管服務，是一個爲開發者提供穩定、高效、安全的雲端軟件開發協作平臺。

1.2 碼雲的功能

除了Git代碼託管這個功能，碼雲還提供代碼在線查看、歷史版本查看、打包下載任意版本、保護分支、代碼質量檢測、PaaS 項目演示等功能。

1.3 碼雲的模式

一個開源項目，開源分爲兩個羣體：核心開發團隊、貢獻者。核心開發團隊，擁有對代碼修改的最終決定權；貢獻者，能查看源代碼但不能對版本庫提交修改。

1.3.1 集中式版本控制系統

使用集中式版本控制系統（如SVN）：

貢獻者不能直接向版本庫提交修改的代碼。
而核心開發團隊，對於涉及到版本庫的操作（查看日誌、創建分支等）都需要在連網的情況下進行，受網絡帶寬的影響比較大。

1.3.2 分佈式版本控制系統

使用分佈式版本控制系統（如Git）：

每個開發者本地都擁有一份完整的版本庫。
Git不排斥集中式模式，但更傾向於將集中式版本庫稱爲共享版本庫。
核心開發團隊與共享版本庫之間不需要一直保持連接狀態（如查看日誌、提交、創建分支等），幾乎全部操作都（脫離網絡）能在本地版本庫中完成。
核心開發團隊和貢獻者（非項目成員）都可以從共享版本庫克隆一份本地版本庫，但只有核心開發團隊成員纔可以將自己的本地版本庫推送到共享版本庫上。

貢獻者（非項目成員）提交自己對項目修改的兩種方式：

用 git format-patch 命令將本地倉庫提交轉換爲補丁文件或補丁文件序列，再通過郵件發送給核心開發團隊。
搭建一個自己的 共享版本庫 ，通過郵件創建一個拉拽請求（Pull Request），讓核心開發團隊成員到自己的版本庫來抓取（Pull）。

1.3.3 碼雲的協同模式

創建者只需在碼雲上點擊創建版本庫，再完成授權和核心開發團隊的組建，項目就創建完成了。

貢獻者參與項目：

找到想參與的項目，在自己的託管空間下創建一個派生（Fork）的項目（對派生項目的版本庫擁有讀寫的完全權限）。
當貢獻者完成開發，並向自己派生的版本庫推送後，通過碼雲向項目的核心開發團隊發送一個 Pull Request，請求審覈。
核心開發團隊收到 Pull Request 後審覈代碼，審覈通過後，執行合併操作接納貢獻者的提交。

如圖所示

二、 Gitee註冊賬號和搭建環境

簡介：介紹初次運行git時的配置、賬號的創建、git客戶端能否訪問git倉庫。

2.1 初次運行前的配置

（ 2.1 這部分作爲理論熟悉，根據自己情況可直接從 2.2 開始操作）

使用前，需要配置自己的Git工作環境，只需要配置一次，以後升級會繼續沿用現在的配置（如果需要修改，可以用相同命令修改配置）。

Git 提供了 git config 工具（即 git-config 命令，通過 git 加一個名字來執行此命令），用來配置或讀取相應的工作環境變量，這些環境變量決定了 Git 在各個環節的具體工作方式和行爲。

變量存放的三個地方：

/etc/gitconfig 文件：系統中對所有用戶都適用的配置（如果使用 git config ，選擇 –system 選項，讀寫的就是這個文件）。
~/.gitconfig 文件：用戶目錄下的配置文件只適用於該用戶（如果使用 git config ，選擇 –global 選項，讀寫的就是這個文件）。
.git/config 文件（當前倉庫的 Git 目錄中的配置文件）：這裏的配置僅僅針對當前倉庫有效（每一個級別的配置都會覆蓋上層的相同配置，所以 .git/config 裏的配置會覆蓋 /etc/gitconfig 中的同名變量）。

2.1.1 配置用戶信息

配置 個人用戶名 和 郵箱地址 ，每次 Git 提交時都會引用這兩條信息，這兩條信息會隨更新內容一起寫入歷史記錄，命令如下

git config --global user.name "用戶名"
git config --global user.email "註冊Gitee的郵箱"

如果使用 --global 選項，更改的配置文件就位於用戶主目錄下，以後 所有倉庫 都會默認使用這裏配置的用戶信息（如果要在某個特定的倉庫中使用其他名字或者郵箱，只要去掉 --global 選項重新配置即可，新的設置保存在當前倉庫的 .git/config 文件裏。）。

2.1.2 文本編輯器配置

Git 需要輸入一些額外信息的時，會自動調用系統默認的文本編輯器，如 Vi 或 Vim 。

如果需要自定義，輸入以下命令（以 Emacd 爲例）

git config --global core.editor emacs

2.1.3 差異分析工具配置

這個命令是在解決合併衝突時，使用哪個差異分析工具。

輸入以下命令（以改用 vimdiff 爲例）

git config --global merge.tool vimdiff

另外，Git 可以理解爲 kdiff3，tkdiff，meld，xxdiff，emerge，vimdiff 等合併工具的輸出信息（可以自定義指定的開發工具）。

2.1.4 查看配置信息

檢查已有的配置信息

git config --list

有時候會看到一樣的變量名，則說明它們來自不同的配置文件（如 /etc/gitconfig 和 ~/.gitconfig ），Git 實際採用最後一個。

查閱某個環境變量的設定（把特定的名字跟在後面即可）

git config user.name

2.2 註冊Gitee賬號

打開 瀏覽器 ，在地址欄輸入 Gitee.com ，敲擊回車，出現以下界面，點擊 加入碼雲

出現以下界面，選擇註冊登錄方式

完成註冊。

2.3 環境的搭建

2.3.1 配置用戶信息

以下操作是用終端模擬器 Cmder ，推薦使用這個工具，這個工具比較便捷，比如需要粘貼，點一下右鍵就粘貼了。如果不想下載這個工具，也可以在終端操作（打開終端快捷鍵：Win + r ，輸入 cmd ）

（下載地址： Cmder下載，也可以在網上找相關資源下載）

打開 Cmder （或終端），輸入 git 查看是否顯示命令的使用方法

git

配置 Git 全局用戶名和郵箱，注意替換用戶名和郵箱

git config --global user.name "用戶名"
git config --global user.email "註冊Gitee的郵箱"

2.3.2 配置免密訪問

配置免密訪問 Gitee.com 。爲了能夠向剛創建的倉庫提交代碼，需要配置加密的密匙到 Gitee.com ，在實現通信加密的同時，不需要用戶每次都驗證賬號輸入密碼。

在 Cmder 輸入以下命令（命令中有雙引號的，在雙引號中輸入郵箱），接着不用輸入， 一路敲擊回車 就可以了

ssh-keygen -t rsa -C "註冊Gitee.com的郵箱地址"

命令執行完後，在 Windows個人用戶目錄 下會生成一個 .ssh目錄，打開後可以看到生成的私鑰和公鑰文件

在.ssh目錄中，新建兩個文本文件 config 和 known_hosts

在 config 文件中加入以下內容（注意文件名要刪掉後綴.txt）

# gitee 指定私鑰路徑
Host gitee.com
HostName gitee.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa

完成後如下

打開公鑰id_rsa.pub文件（以記事本形式打開），複製裏面的內容

在 known_hosts 文件中加入複製的內容，把末尾的 郵箱名刪掉 （注意文件名要刪掉後綴.txt）

gitee.com <粘貼id_rsa.pub的內容，並去掉它結尾的郵箱>

完成後如下

登錄 Gitee ，點擊超鏈接進入碼雲添加SSH公鑰，熟悉的話也可以按一下操作進入。

鼠標移到右上角頭像處，點擊設置

再點擊 SSH公鑰 ，在這裏添加公鑰。

打開後填入一下信息，把公鑰id_rsa.pub 的把所有內容複製這裏，點擊確定

點擊確定後，會彈出提示，按提示輸入驗證身份就可以了

驗證成功後，打開 Cmder 輸入下面命令測試認證Gitee.com 是否成功

ssh -T git@gitee.com

認證成功，繼續下面的操作。

三、創建Gitee倉庫和提交代碼

簡介：介紹Gitee倉庫的創建、使用Git提交代碼。

3.1 創建倉庫

登錄 Gitee.com ，點擊右上角的 + 號，再點擊 新建倉庫

填寫 倉庫名稱 ，設置公開（一般指的是開源項目）或者私有，其他默認（也可以根據自己需要選擇）

這裏要勾選上（如果不勾選，到時候操作不太方便，比如需要用git命令創建倉庫）

選擇 分支模型 爲 特性/發佈模型（根據具體需要選擇，比如選擇單分支模型），點擊創建，倉庫創建完成。

打開倉庫，點擊代碼，選擇 SSH ，複製倉庫的SSH訪問鏈接（注意選擇的是SSH協議，不是HTTPS協議）

如果以後需要查看 遠程倉庫 的 訪問連接 ，打開倉庫後點擊代碼，在右側點擊 克隆/下載 ，再選擇所需要的複製

打開 Cmder ，選擇存放倉庫的地方（根據自己情況選擇），輸入以下命令

d:
mkdir d:\GitTest
cd d:\GitTest
git clone 倉庫的SSH訪問鏈接

進入上面所創建目錄，查看目錄，檢查倉庫是否下載成功

3.2 代碼提交

3.2.1 提交過程

把需要提交的代碼解壓到該目錄下

進入到克隆下來的倉庫

cd Gitdemo

把代碼加入到 暫存區

git add *

查看 暫存區 的代碼，可以看到文件處於new file狀態

git status

把代碼提交到 本地倉庫 ，雙引號內寫入本次提交的註釋，命令如下

git commit -m "提交內容註釋"

再次查看 暫存區 ，查看暫存區文件狀態，如下圖，暫存區沒有還沒提交到 本地倉庫 的文件

將 本地倉庫 提交到 遠程倉庫 （即Gitee倉庫）

git push

通過 瀏覽器 打開 Gitee倉庫，查看代碼是否提交，可以看到提交記錄等信息

3.2.2 修改後再次提交演示

（ 3.2.2 的操作，以上面上傳的代碼爲例，請根據自己的代碼修改）

以 記事本 形式打開 .html 文件，對代碼進行修改，修改前如下

修改完後，點擊保存

用瀏覽器打開該文件，查看是否修改成功

根據3.2.1的操作命令，把修改後的代碼提交到遠程倉庫

用到下面這幾條命令

git add *
git status
git commit -m "提交內容註釋"
git push

把修改的文件放入 暫存區 （注意這兩條命令： git add是把修改的代碼放入暫存區，git add *是把當前目錄所以修改的文件都放入暫存區）

查看暫存區狀態，再把 暫存區 代碼提交到 本地倉庫

檢查暫存區狀態，把 本地倉庫 推送到 遠程倉庫

再打開瀏覽器，查看該遠程倉庫日誌，查看是否提交成功

好了，代碼提交演示完成。

四、分支與標籤的管理

簡介：介紹如何管理git的分支，如何使用分支進行開發、修復bug。

4.1 管理的背景

在軟件開發行業中，有一種常見的版本號分類方法，就是使用數字標記，用點（dot）符號隔開，隨着每次版本的更新數字會遞增。軟件版本有： 開發版 (develop)， 新特性版本 (feature)， 正式版 ， 修復版 (hotfix) 。

例如 1.2.8 這個版本號，通常 1 代表 大版本號 ，代表軟件的重大改版更新，架構的大更改； 2 代表 小版本號 ，一般是新增一些小功能或模塊； 6 代表 功能修復 ，就是大家常說的修復bug。

4.2 操作思路

master 是主幹分支， 正式版 一般要從主幹分支發佈。

發佈前要在版本位置上標記上版本信息（即打標籤），通過打標籤，方便以後知道發佈的版本對應着哪一次提交的內容。

以上面的創建爲例，版本號爲 v1.0.0 ，發佈三個版本：

正式版v1.0.0。
正式版v1.0.1，包含一個bug修復（hotfix）。
新特性開發版v1.0.0 Build-20200518，包含一個新特性。

4.3 操作步驟

4.3.1 發佈正式版

查看本地倉庫的分支，*表示當前分支

git branch

查看本地倉庫提交歷史（發行版本前，要確定該版本有哪些提交內容）

git log

給 master 分支（主幹）打上標籤 v1.0.0

git tag -a v1.0.0 -m '正式版v1.0.0'

查看所有的標籤

git tag -l

將新增的標籤提交到遠程倉庫

git push --follow-tags

查看標籤是否提交，打開 瀏覽器 ，查看 遠程倉庫 ，點擊統計，再點擊標籤

在下面這裏點擊 發行版 ，可以創建遠程倉庫的發行版，這樣別人就可以直接下載該版本的應用了（在此就不演示這個操作了）

4.3.2 修復正式版（熱修復補丁）

如果需要修復bug（假設正式版v1.0.0發現了一個bug），在 master 分支上，基於 v1.0.0 來修復這個bug，從標籤 v1.0.0 新增一個分支來修復

git checkout -b hotfix-v1.0.1 v1.0.0

查看是否新增的 hotfix-v1.0.1 分支，並且當前正處於這個分支上

git branch

如果想切換分支，可以輸入這個命令來切換不同的分支

git checkout 分支名稱

接着以 記事本 形式打開.html文件（和上面一樣，請根據自己的代碼修改，文章代碼的操作演示，是根據我提交的代碼來操作的），修改前如圖所示

修改爲 正式版v1.0.1 ，點擊保存

接着，在 Cmder 輸入以下命令，提交修改

git add index.html

git commit -m "提交內容的註釋"

git push

因爲 hotfix-v1.0.1 只是一個臨時分支，所有修改完後要合併到 master 分支。

切換到 master 分支

// An highlighted block
var foo = 'bar';

把 hotfix-v1.0.1 分支的修改合併到 master 分支上

git merge --no-ff hotfix-v1.0.1

加上標籤 正式版v1.0.1

git tag -a v1.0.1 -m "正式版v1.0.1"

hotfix-v1.0.1 分支已經合併到 master 分支上，爲了方便維護，一般會刪掉這個分支，輸入以下命令

git branch -d hotfix-v1.0.1

接着 push 推送到 遠程倉庫 ，輸入以下命令

git push --follow-tags

查看新的 Tag 是否存在

git tag -l

打開 瀏覽器 ，檢驗以下是否提交成功

提交完成。

4.3.3 發佈新特性版

開發一個 新特性版v1.1.0 （假設這個版本短時間內開發不完，需要以迭代方式開發），每日發佈一個開發版（版本號後面加上Build的日期）。比如第一次開發是2020年5月18日，則版本號就是v1.1.0 Build-20200518。

爲了不影響 master 分支的正常維護（master 分支可能還要發佈修復bug），一般需要在v1.0.1 標籤這裏再新建一個develop分支，輸入命令如下

git checkout -b develop v1.0.1

修改代碼內容（請根據自己代碼修改）

修改後如下

把修改的代碼放入 暫存區

git add 文件名

把 暫存區 的代碼提交到 本地倉庫

git commit -m "提交內容的註釋"

使用的標籤標記爲 v1.1.0-Build-20200518

git tag -a '標籤' -m "標籤描述"

建立追蹤關係，設置本地倉庫的分支（好像默認都有origin）對應遠程倉庫的分支

git push --set-upstream 現有分支 遠程分支

把本地倉庫提交到遠程倉庫，輸入以下命令（該命令是追隨標籤提交）

git push --follow-tags

打開 瀏覽器 進入倉庫，檢驗是否提交成功

好了，提交完成。

五、常用命令

簡介：介紹操作時經常使用到的Git命令。

5.1 Git本地倉庫

git本地倉庫：

工作區
版本庫——.git隱藏文件夾
暫存區——修改了的文件，還沒提交到倉庫
提交狀態

5.2 Git常使用到的命令

clone，add，commit，push，fetch，pull，merge

本地倉庫與遠程倉庫之間的聯繫命令：

命令	解釋
git clone	從遠程倉庫克隆到本地倉庫，具體： git clone 訪問路徑
git pull	拉取遠程倉庫的代碼到本地倉庫並自動合併
git fetch	下載遠程倉庫的所有變動
git push	從本地倉庫推送到遠程倉庫

git clone 與 git pull 的區別：

git clone 不需要本地初始化倉庫，git pull 則需要。
git clone 本地無需是一個倉庫，且克隆將設置額外的遠程跟蹤分支，文件夾.git裏存放與遠程倉庫一樣的版本庫記錄。

本地倉庫與暫存區之間的聯繫命令：

命令	解釋
git status	查看暫存區狀態
git add	把修改的代碼放入暫存區
git add *	把當前目錄所有修改的文件都加入暫存區
git commit -m “提交內容的註釋”	把暫存區代碼提交到本地倉庫

對分支的操作：

命令	解釋
git merge 指定分支	合併指定分支到當前分支
git branch	查看所以本地分支
git branch -d 分支	合併後刪除分支

查看歷史信息：

命令	解釋
git log	查看當前分支的提交歷史記錄
git log -S 關鍵詞	根據關鍵詞搜索提交歷史
git status	顯示有變更的文件

六、操作時遇到的問題

簡介：介紹操作時常遇到的問題。

6.1 修改文件擴展名的方法

需要刪掉文件後綴的時候，找不到文件的擴展名，點擊查看，勾選 文件擴展名

找到需要修改的文件，點擊文件，右鍵選擇 重命名 ，再修改

點擊確定

擴展名修改完成

6.2 Cmder 提示error: cannot spawn less: No such file or directory

解決方法：把計算機名修改爲英文名

點擊 此電腦 ，右鍵屬性，選擇 系統保護 或者 高級系統設置

再在彈出的窗口選擇 計算機名 ，接着修改就可以了

6.3 克隆倉庫時提示 warning: You appear to have cloned an empty repository

提示克隆了一個空倉庫，這個提示可以忽略的。上面的操作，新建倉庫還沒有放入內容，就彈出了這個提示，對接下來的操作沒有影響的。

6.4 Cmder 提示 Bad owner or permissions on

可能是Windows用戶不能訪問 .ssh目錄 ，導致創建密鑰失敗，解決操作：

找到 .ssh 文件夾（一般位於用戶目錄下，即 C:\Users\Windows用戶名 這個目錄裏面）
右鍵 .ssh 文件夾，點擊屬性
點擊安全 --> 高級，在彈出的界面的左下角，點擊 禁用繼承 ，再點擊確定
彈出提示窗口，點擊 從象中刪除所有繼承的權限 ，接着你會看到所有用戶都刪除掉了，讓我們添加所有者
在這個窗口中，點擊編輯 --> 添加 --> 選擇用戶或組 --> 高級 --> 立即查找 ，點擊後會顯示用戶列表
選擇你的用戶賬戶
接着一路點擊確定，就解決這個問題了

6.4 執行 ssh-keygen 時提示 could not create directory ‘c:\xxx\ssh’:Invalid argument

可能是Windows的用戶名採用了中文或特殊字符，因爲命令參數不支持中文和特殊字符，所有導致了創建目錄失敗，修改下用戶名就可以了。

也有可能是沒有C盤的訪問權限，如果是權限問題，請參考 6.3 的解決方法。

6.5 輸入命令後提示 error: invalid key 或 error: invalid argument

查看命令是不是少打空格等，導致參數錯誤。

6.6 提示 fatal:Authentication failed for ‘https://gitee.com/xxxx’

這個提示是因爲使用HTTPS協議管理遠程倉庫，卻使用了錯誤的gitee用戶名和密碼，輸入正確的註冊郵箱和密碼就可以解決這個問題了。

6.7 提示 Please tell me who you are

這個提示是因爲 Git的 user.name 和 user.email 沒有配置，隨意導致遠程倉庫認證失敗，配置 gitee用戶名和認證郵箱就可以解決這個問題了。

6.8 提示 warning:LF will be replaced by CRLF in xxxx The file will have its original line endings in your working directory

Git提交到遠程倉庫時，自動把提交文件的 Windows的分行符轉換爲 Linux/Unix的分行符，這個提示可以忽略。

6.9 ssh: connect to host git.com port 22: Connection timed out

這是輸錯命令的了，看清楚命令-。-

好了，總結完了，繼續學習。