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

/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 創建倉庫

3.1.1 創建遠程倉庫

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

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

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

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

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

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

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

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

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

3.1.2 創建本地倉庫

如果想創建一共git的本地倉庫，則按以下操作。

進入到想創建本地git倉庫的文件夾，用以下命令（路徑是指git本地倉庫的路徑），

cd 路徑

把這個目錄設置成git本地倉庫，輸入以下命令

git init

打開文件夾，發現生成了一個 .git 文件，表示git的本地倉庫創建成功。

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.1.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

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

好了，提交完成。

4.4 刪除指定分支的文件

簡介：這一小節就不截圖演示了，直接介紹怎樣操作。

輸入以下命令進入到 Git本地倉庫

cd 本地倉庫路徑

查看分支

git branch -a

切換到想操作的分支

git branch [branch]

在本地倉庫刪除想要刪除的文件

git rm [file]  //如果想刪掉所有文件，則用 * 替代文件名

或者用下面這句命令刪除

git rm -r [file]  // -r表示遞歸所有子目錄

刪除後再進行提交（提交到本地倉庫）

git commit -m "提交描述"

最後推送到遠程倉庫

git push origin [branch]

五、常用命令

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

5.1 Git相關說明

5.1.1 git本地各部分介紹

git本地倉庫：

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

關於 暫存區 介紹：

本地倉庫裏面存放了很多東西，其中有個很重要的叫做stage（或者叫index）的暫存區。
git自動創建的第一個分支爲master，指向master的一個指針叫做HEAD。

工作區、暫存區、本地版本庫、遠程版本庫 之間的關係如下（圖片是大二時的資料，源於網絡）：

5.1.2 分支介紹

分支	說明
mater	默認開發分支
origin	默認遠程版本庫
HEAD	指向當前分支的最新提交
HEAD^	HEAD的父提交

5.2 Git常使用到的命令

5.2.1 實用Git命令列表

git clone ：從git服務器（遠程倉庫）拉取代碼。
git config ：配置用戶名和郵箱。
git branch ：操作項目分支（創建、重命名、查看、刪除）。項目開發一般是在開發分支進行，開發完後再合併到主幹。
git checkout ：切換分支。
git status ：查看文件變動狀態。
git add ：將文件添加到暫存區。
git commit ：提交文件變動到版本庫（本地倉庫）。
git push ：將本地代碼推送到服務器（遠程倉庫）。
git pull ：將服務器（遠程倉庫）上的最新代碼拉取到本地。
git log ：查看版本提交記錄（按j往下翻，按k往上翻，按q退出查看）。
git tag ：爲項目標記標籤。
.gitignore ：設置哪些內容不需要推送到服務器（遠程倉庫）。

關於 .gitignore 操作的介紹：

這是一個配置文件（不是Git的命令），在項目中，通過命令 touch .gitignore 創建一個.gitignore文件，通過編輯器打開創建的這個文件，添加忽略的文件或目錄（每行代表一個忽略的文件或目錄）。

5.2.2 操作之間聯繫的命令

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

命令	解釋
git remote -v	查看遠程倉庫信息
git remote show [remote]	查看指定遠程倉庫信息
git init	初始化本地版本庫
git clone [url]	克隆遠程倉庫,url指的是遠程倉庫地址
git pull [remote] [branch]	拉取遠程倉庫的代碼到本地倉庫並自動合併
git fetch [remote]	下載遠程倉庫的所有變動
git push	從本地倉庫推送到遠程倉庫
git push [remote] [branch]	上傳代碼併合並
git push --tags	上傳所有標籤

git clone 與 git pull 的區別：

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

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

命令	解釋
git status	查看暫存區狀態
git diff	查看變更內容
git add	把修改的代碼放入暫存區
git add *	把當前目錄所有修改的文件都加入暫存區
git add .	跟蹤所有改動過的文件（別漏掉 . 這點）
git add [file]	跟蹤指定的文件
git rm --cached [file]	停止跟蹤文件但不刪除
git rm [file]	刪除文件
git mv [old] [new]	文件改名
git commit --amend	修改最後一次提交
git commit -m [message]	把暫存區代碼提交到本地倉庫

對分支的操作：

命令	解釋
git merge [branch]	合併指定分支到當前分支
git branch	查看所有本地分支
git branch [branch-name]	創建新分支
git branch -d [branch]	合併後刪除分支
git checkout [branch]	切換到指定分支
git branch -m [branch-name] [branch-name-new]	重命名分支

對標籤的操作

命令	解釋
git tag	查看所有本地標籤
git tag [tag-name]	在當前提交(commit)新建一個標籤
git tag [tag] [commit]	在指定提交新建一個標籤
git tag -d [tag]	刪除標籤

撤銷的命令

命令	解釋
git reset --hard	重置暫存區與工作區（與上一次commit保持一致）
git revert [commit]	撤銷指定的提交

查看歷史信息：

命令	解釋
git log	查看當前分支的提交歷史記錄
git log -p [file]	查看指定文件的提交歷史
git log -S 關鍵詞	根據關鍵詞搜索提交歷史
git blame [file]	以列表方式查看指定文件的提交歷史
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

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

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