[[392568]]

只有在遇到問題的時(shí)候，才體會(huì)到技巧帶來(lái)的好處！

常見企業(yè)工作流程

主要介紹，企業(yè)中常用的 Git 工作流程！

Git Flow

•  主干分支
•  穩(wěn)定分支
•  開發(fā)分支
•  補(bǔ)丁分支
•  修改分支

Github Flow

•  創(chuàng)建分支
•  添加提交
•  提交 PR 請(qǐng)求
•  討論和評(píng)估代碼
•  部署檢測(cè)
•  合并代碼

Gitlab Flow

•  帶生產(chǎn)分支
•  帶環(huán)境分支
•  帶發(fā)布分支

日常使用最佳實(shí)踐

總結(jié)日常工作中應(yīng)該遵循的 Git 使用方式和方法！

•  使用命令行代替圖形化界面
  •  使用命令行來(lái)操作，簡(jiǎn)潔且效率高
•  提交應(yīng)該盡可能的表述提交修改內(nèi)容
  •  區(qū)分 subject 和 body 內(nèi)容，使用空行隔開
  •  subject 一般不超過 50 個(gè)字符
  •  body 每一行的長(zhǎng)度控制在 72 個(gè)字符
  •  subject 結(jié)尾不需要使用句號(hào)或者點(diǎn)號(hào)結(jié)尾
  •  body 用來(lái)詳細(xì)解釋此次提交具體做了什么
•  使用 .gitignore 文件來(lái)排除無(wú)用文件
  •  可使用模板文件，然后根據(jù)項(xiàng)目實(shí)際進(jìn)行修改
•     基于分支或 fork 的開發(fā)模式
  •  不要直接在主干分支上面進(jìn)行開發(fā)
  •   在新建的分支上進(jìn)行功能的開發(fā)和問題的修復(fù)
•     使用 release 分支和 tag 標(biāo)記進(jìn)行版本管理
  •   使用 release 分支發(fā)布代碼和版本維護(hù)(release/1.32)
  •   使用 tag 來(lái)標(biāo)記版本(A-大feature功能.B-小feature功能.C-只修bug)

常用命令匯總整理

日常使用只要記住 6 個(gè)命令就可以了。

 

# 工作區(qū) -> 暫存區(qū)  
$ git add <file/dir>  
# 暫存區(qū) -> 本地倉(cāng)庫(kù)  
$ git commit -m "some info"  
# 本地倉(cāng)庫(kù) -> 遠(yuǎn)程倉(cāng)庫(kù)  
$ git push origin master  # 本地master分支推送到遠(yuǎn)程origin倉(cāng)庫(kù)  

# 工作區(qū) <- 暫存區(qū)  
$ git checkout -- <file>  # 暫存區(qū)文件內(nèi)容覆蓋工作區(qū)文件內(nèi)容  
# 暫存區(qū) <- 本地倉(cāng)庫(kù)  
$ git reset HEAD <file>   # 本地倉(cāng)庫(kù)文件內(nèi)容覆蓋暫存區(qū)文件內(nèi)容  
# 本地倉(cāng)庫(kù) <- 遠(yuǎn)程倉(cāng)庫(kù)  
$ git clone <git_url>        # 克隆遠(yuǎn)程倉(cāng)庫(kù)  
$ git fetch upstream master  # 拉取遠(yuǎn)程代碼到本地但不應(yīng)用在當(dāng)前分支  
$ git pull upstream master   # 拉取遠(yuǎn)程代碼到本地但應(yīng)用在當(dāng)前分支  
$ git pull --rebase upstream master  # 如果平時(shí)使用rebase合并代碼則加上  

# 工作區(qū) <- 本地倉(cāng)庫(kù)  
$ git reset <commit>          # 本地倉(cāng)庫(kù)覆蓋到工作區(qū)(保存回退文件內(nèi)容修改)  
$ git reset --mixed <commit>  # 本地倉(cāng)庫(kù)覆蓋到工作區(qū)(保存回退文件內(nèi)容修改)  
$ git reset --soft <commit>   # 本地倉(cāng)庫(kù)覆蓋到工作區(qū)(保留修改并加到暫存區(qū))  
$ git reset --hard <commit>   # 本地倉(cāng)庫(kù)覆蓋到工作區(qū)(不保留修改直接刪除掉) 

配置實(shí)用參數(shù)選項(xiàng)

雖然配置比較簡(jiǎn)單，但是非常有用！

全局配置 

# 用戶信息  
$ git config --global user.name "your_name"  
$ git config --global user.email "your_email"  
# 文本編輯器  
$ git config --global core.editor "nvim"  
# 分頁(yè)器  
$ git config --global core.pager "more"  
# 別名  
$ git config --global alias.gs "git status"  
# 糾錯(cuò)  
$ git config --global help.autocorrect 1 

個(gè)人配置 

# 不加--global參數(shù)的話，則為個(gè)人配置  
$ git config --list  
$ git config user.name  
$ git config user.name "your_name"  
# 如果在項(xiàng)目中設(shè)置，則保存在.git/config文件里面  
$ cat .git/config  
[user]  
    name = "your_name"  
...... 

合并和變基的選擇

到底什么時(shí)候使用 merge 操作，什么時(shí)候使用 rebase 操作呢？

使用 merge 操作 - Python 中的 Requests 庫(kù)在使用

支持使用 merge 的開發(fā)者，他們認(rèn)為倉(cāng)庫(kù)的提交歷史就是記錄實(shí)際發(fā)生過什么，它是針對(duì)于歷史的一個(gè)文檔，本身其實(shí)是有價(jià)值的，我們不應(yīng)該隨意修改。我們改變歷史的話，就相當(dāng)于使用“謊言”來(lái)掩蓋實(shí)際發(fā)生過的事情，而這些痕跡是應(yīng)該被保留的。可能，這樣并不是很好。 

# 3rd的兩個(gè)分支的commit修改相同內(nèi)容  
*   62a322d - (HEAD->master) Merge branch 'hotfix3' into master  
|\  
| * 6fa8f4a - (hotfix3) 3rd commit in hotfix3  
* | 548d681 - 3rd commit in master  
|/  
* 6ba4a08 - 2nd commit  
* 22afcc1 - 1st commit 

使用 rebase 操作 - Python 中的 Django 庫(kù)在使用

支持使用 rebase 的開發(fā)者，他們認(rèn)為提交歷史是項(xiàng)目過程中發(fā)生過的事情，需要項(xiàng)目的主干非常的干凈。而使用 merge 操作會(huì)生成一個(gè) merge 的 commit 對(duì)象，讓提交歷史多了一些非常多余的內(nèi)容。

當(dāng)我們后期，使用 log 命令參看提交歷史的話，會(huì)發(fā)現(xiàn)主干的提交歷史非常的尷尬。比如，同樣的修改內(nèi)容重復(fù)提交了兩次，這顯然是分支合并導(dǎo)致的問題。 

# 3rd的兩個(gè)分支的commit修改相同內(nèi)容  
* 697167e - (HEAD -> master, hotfix) 3rd commit  
* 6ba4a08 - 2nd commit (2 minutes ago)  
* 22afcc1 - 1st commit (3 minutes ago) 

兩者的使用原則

總的原則就是，只對(duì)尚未推送或分享給其他人的本地修改執(zhí)行變基操作清理歷史，從不對(duì)已經(jīng)推送到倉(cāng)庫(kù)的提交記錄執(zhí)行變基操作，這樣，你才可能享受到兩種方式帶來(lái)的便利。

更新倉(cāng)庫(kù)提交歷史

Git 提供了一些工具，可以幫助我們完善版本庫(kù)中的提交內(nèi)容，比如：

合并多個(gè) commit 提交記錄

日常開發(fā)中，我們?yōu)榱送瓿梢粋€(gè)功能或者特性，提交很多個(gè) commit 記錄。但是在最后，提交 PR 之前，一般情況下，我們是應(yīng)該整理下這些提交記錄的。有些 commit 需要合并起來(lái)，或者需要將其刪除掉，等等。 

# 調(diào)整最近五次的提交記錄  
$ git rebase -i HEAD~5  
$ git rebase -i 5af4zd35  # 往前第六次的commit值  
reword c2aeb6e 3rd commit  
squash 25a3122 4th commit  
pick 5d36f1d 5th commit  
fixup bd5d32f 6th commit  
drop 581e96d 7th commit  
# 查看提交歷史記錄  
$ git log  
* ce813eb - (HEAD -> master) 5th commit  
* aa2f043 - 3rd commit -> modified  
* 6c5418f - 2nd commit  
* c8f7dea - 1st commit 

刪除意外調(diào)試的測(cè)試代碼

有時(shí)候提交之后，我們才發(fā)現(xiàn)提交的歷史記錄中存在這一些問題，而這個(gè)時(shí)候我們又不想新生成一個(gè) commit 記錄，且達(dá)到一個(gè)修改的目錄。即，修改之前的 commit 提交記錄。 

# 不使用分頁(yè)器  
$ git --no-pager log --oneline -1  
d5e96d9 (HEAD -> master) say file  
# 改變提交信息并加入暫存區(qū)  
$ echo "hello" > say.txt  
$ git add -u   
# 改變當(dāng)前最新一次提交記錄 
$ git commit --amend  
# 改變且息不改變提交信  
$ git commit --amend --no-edit  
# 改變當(dāng)前最新一次提交記錄并修改信息  
$ git commit --amend -m "some_info"  
# 不使用分頁(yè)器  
$ git --no-pager log --oneline -1  
9e1e0eb (HEAD -> master) say file 

取消多個(gè) commit 中的部分提交

我們開發(fā)了一個(gè)功能，而在上線的時(shí)候，產(chǎn)品經(jīng)理說(shuō)這個(gè)功能的部分特性已經(jīng)不需要了，即相關(guān)特性的提交記錄和內(nèi)容就可以忽略/刪除掉了。 

# 回滾操作(可多次執(zhí)行回滾操作)  
# 徹底上次提交記錄；也可是PR的提交記錄  
# 默認(rèn)會(huì)生成一個(gè)類型為reverts的新commit對(duì)象  
$ git revert 3zj5sldl  
[4] 合并某些特定的 commit 提交  
我們不希望合并整個(gè)分支，而是需要合并該分支的某些提交記錄就可以了。  
bash  
# 摘櫻桃  
$ git cherry-pick -x z562e23d 

使用引用日志記錄

如何找回我們丟失的內(nèi)容和記錄？

我們之前說(shuō)過，使用下面命令回退內(nèi)容、強(qiáng)制推送代碼、刪除本地分支，都是非常危險(xiǎn)的操作，因?yàn)橹刂弥笪覀兙蜎]有辦法在找到之前的修改內(nèi)容了。 

# 回退  
$ git reset --hard <commit>  
# 推送  
$ git push origin master -f  
# 分支  
$ git branch -D <branch_name> 

其實(shí) Git 給我們留了一個(gè)后門，就是使用 relflog 命令來(lái)找回之前的內(nèi)容，只不過是相對(duì)來(lái)說(shuō)麻煩一些。而原理也很簡(jiǎn)答，就是在我們使用 Git 命令操作倉(cāng)庫(kù)的時(shí)候，Git 偷偷地幫助我們把所有的操作記錄了下來(lái)。 

# 查看日志記錄  
$ git --no-pager log --oneline -1  
4bc8703 (HEAD -> master) hhhh  
# 回退到上次提交  
$ git reset --hard HEAD~1  
# 查看引用日志記錄  
$ git reflog  
6a89f1b (HEAD -> master) HEAD@{0}: reset: moving to HEAD~1  
4bc8703 HEAD@{1}: commit (amend): hhhh  
# 找回內(nèi)容  
$ git cherry-pick 4bc8703 

批量修改歷史提交

批量修改歷史提交雖然不常用，但是理解的話可以省下很多時(shí)間！

之前我們學(xué)習(xí)到的命令都是針對(duì)于一個(gè)或者多個(gè) commit 提交信息進(jìn)行修改的，如果我們需要全局修改歷史提交呢？當(dāng)然，Git 中也是支持全局修改歷史提交的，比如全局修改郵箱地址，或者將一個(gè)文件從全局歷史中刪除或修改。

•  開源項(xiàng)目中使用了公司郵箱進(jìn)行提交了
•  提交文件中包含隱私性的密碼相關(guān)信息
•  提交時(shí)將大文件提交到了倉(cāng)庫(kù)代碼中了

這里我們可以使用 filter-brach 的方式進(jìn)行修改，但是建議在使用之前，新建一個(gè)分支，在上面進(jìn)行測(cè)試沒有問題之后，再在主干上操作，防止出現(xiàn)問題，背個(gè)大鍋在身上。 

# 創(chuàng)建分支  
$ git branch -b testing  
# 修改郵箱地址  
$ git filter-branch --commit-filter '  
    if [ "$GIT_AUTHOR_EMAIL" == "escape@escapelife.site" ]; then  
        GIT_AUTHOR_NAME="escape";  
        GIT_AUTHOR_EMAIL="escape@gmail.com";  
        git commit-tree "$@"  
    else  
        git commit-tree "$@"  
  fi' HEAD 

靈活使用鉤子函數(shù)

主要介紹.git/hooks 目錄下面的示例鉤子函數(shù)！

在 Git 里面有兩類，分別對(duì)應(yīng)客戶端和服務(wù)端鉤子函數(shù)。客戶端的鉤子函數(shù)，是在執(zhí)行提交和合并之類的操作時(shí)調(diào)用的。而服務(wù)端鉤子函數(shù)，就是當(dāng)服務(wù)端收到代碼提交之后，可以出發(fā)代碼檢查和持續(xù)集成的步驟。作為開發(fā)者我們并不會(huì)搭建 Git 服務(wù)器，所以基本不會(huì)涉及。

下面就是 Git 自帶的鉤子腳本，但是自帶的都以 .sample 作為后綴，表示并沒有啟用，表示為一個(gè)示例。如果需要啟用的話，將 .sample 作為后綴刪除掉，即可。而其鉤子腳本的對(duì)應(yīng)內(nèi)容，都是使用 Shell 語(yǔ)法進(jìn)行編寫的。 

➜ ll .git/hooks  
total 112  
-rwxr-xr-x  applypatch-msg.sample  
-rwxr-xr-x  commit-msg.sample  
-rwxr-xr-x  fsmonitor-watchman.sample  
-rwxr-xr-x  post-update.sample 
-rwxr-xr-x  pre-applypatch.sample  
-rwxr-xr-x  pre-commit.sample  
-rwxr-xr-x  pre-merge-commit.sample  
-rwxr-xr-x  pre-push.sample  # 不會(huì)推送包含WIP的commit提交  
-rwxr-xr-x  pre-rebase.sample  
-rwxr-xr-x  pre-receive.sample  
-rwxr-xr-x  prepare-commit-msg.sample  
-rwxr-xr-x  update.sample 

其實(shí)，鉤子腳本使用任何語(yǔ)言編寫都是可以的，只要你讓程序返回對(duì)應(yīng)的退出碼就可以了。

正常的代碼合入流程就是，我們本地修改之后，提一個(gè) PR 請(qǐng)求并通過 Github 的 CI 檢查，接下來(lái)進(jìn)行代碼評(píng)審，最后被合并入主干。但是，好的一個(gè)習(xí)慣就是，在代碼提交之前就應(yīng)該保證代碼不會(huì)出現(xiàn)語(yǔ)法錯(cuò)誤等基礎(chǔ)問題，比如通過 flake8 和 PEP8 標(biāo)準(zhǔn)等。

這個(gè)時(shí)候我們就可以使用 pre-commit 這個(gè) Github 的開源項(xiàng)目了，其本質(zhì)就是給項(xiàng)目添加鉤子函數(shù)的一個(gè)腳本，可以保證我們?cè)谔峤淮a或者推送代碼之前，先檢查代碼的質(zhì)量。

而 pre-commit-hooks 這個(gè)項(xiàng)目里面包含的就是，現(xiàn)在所支持的鉤子腳本，即開箱即用的鉤子腳本集合。而其鉤子腳本的對(duì)應(yīng)內(nèi)容，都是使用 Python 語(yǔ)法進(jìn)行編寫的。 

# 安裝方式  
$ pip install pre-commit  
# 指定hook類型(即在哪里檢查)  
$ pre-commit install -f --hook-type pre-push  
# 配置需要執(zhí)行的檢查  
$ cat .pre-commit-config.yaml  
repos:  
- repo: https://github.com/pre-commit/pre-commit-hooks  
  rev: v2.9.2  
  hooks:  
    - id: trailing-whitespace  
    - id: flake8  
# 執(zhí)行push操作時(shí)檢查  
$ git push origin master 

快速克隆大型項(xiàng)目

在大項(xiàng)目中工作中，拉取代碼非常占時(shí)間！

我們?nèi)绻霝?Linux 或 Python 這樣的大型項(xiàng)目貢獻(xiàn)提交的時(shí)候，首先遇到的問題就是，如果快速的 clone 該項(xiàng)目到本地。因?yàn)楦捻?xiàng)目提交歷史超多且倉(cāng)庫(kù)巨大，加了國(guó)內(nèi)網(wǎng)絡(luò)的問題，可能等項(xiàng)目完全拉下來(lái)的時(shí)候，我們的熱情都消減下去了。

好在 Git 也幫我們想到了這樣的問題，我們可以使用 --depth 參數(shù)值拉取遠(yuǎn)程倉(cāng)庫(kù)上面最新一次的提交歷史，并不包含項(xiàng)目歷史記錄，即 .git/objects/ 目錄下的對(duì)象只是本地的，并不包含之前的多次修改產(chǎn)生的對(duì)象。 

# 克隆不包含之前歷史  
$ git clone http://xxx.xx.xxx/xxx --depth=1  
但是，有時(shí)間我們可能會(huì)需要 clone 倉(cāng)庫(kù)中的某個(gè) tag 版本對(duì)應(yīng)下的內(nèi)容。如果我們直接使用 clone 命令是無(wú)法做到的，需要執(zhí)行如下操作，即可完美解決。  

# 克隆特定版本代碼  
$ git init xxx-15-0-1  
$ git remote add origin http://xxx.xx.xxx/xxx  
$ git -c protocol.version=2 fetch origin 15.0.1 --depth=1  
$ git checkout FETCH_HEAD 

上面的效果已經(jīng)基本可以滿足我們?nèi)粘Ｊ褂眯枨罅耍遣恍业氖牵悻F(xiàn)在接受了一個(gè)機(jī)器學(xué)習(xí)的項(xiàng)目，里面包含了大量的 lfs 文件，現(xiàn)在 clone 又會(huì)變得非常慢。可以使用如下操作來(lái)避免，Git 工具主動(dòng)拉去 lfs 文件，來(lái)達(dá)到目錄。 

# 克隆不包含LFS數(shù)據(jù)  
$ GIT_LFS_SKIP_SMUDGE=1 git clone http://xxx.xx.xxx/xxx 

如何處理工作中斷

如果在多路運(yùn)轉(zhuǎn)的時(shí)候，還能夠高效的進(jìn)行開發(fā)！

比如，我們現(xiàn)在正在一個(gè)分支為項(xiàng)目添加一個(gè)小的功能，此時(shí)，產(chǎn)品經(jīng)理找到你說(shuō)是線上環(huán)境現(xiàn)在有一個(gè) bug 需要讓你來(lái)修復(fù)下。但是，此時(shí)我們添加的小功能并沒有完成。

如果此時(shí)，我們直接切換到主干分支的話，會(huì)將之前分支沒有來(lái)得及提交的內(nèi)容全部都帶到了主干分支上來(lái)，這是我們不想看到的情況。此時(shí)，我們需要保存上個(gè)分支的工作狀態(tài)，在我們修改完成線上 bug 之后，再繼續(xù)工作。

好在 Git 也幫我們想到了這樣的問題，我們可以使用 stash 子命令幫助我們將當(dāng)前工作區(qū)、暫存區(qū)當(dāng)中的修改都保存到堆棧之中。等到需要處理的時(shí)候，再?gòu)棾龆褩Ｖ械膬?nèi)容，我們?cè)俅芜M(jìn)行開發(fā)。 

➜ git stash -h  
usage: git stash list [<options>]  
   or: git stash show [<options>] [<stash>]  
   or: git stash drop [-q|--quiet] [<stash>]  
   or: git stash ( pop | apply ) [--index] [-q|--quiet] [<stash>]  
   or: git stash branch <branchname> [<stash>]  
   or: git stash clear  
   or: git stash [push [-p|--patch] [-k|--[no-]keep-index] [-q|--quiet]  
          [-u|--include-untracked] [-a|--all] [-m|--message <message>]  
          [--pathspec-from-file=<file> [--pathspec-file-nul]]  
          [--] [<pathspec>...]]  
   or: git stash save [-p|--patch] [-k|--[no-]keep-index] [-q|--quiet]  
          [-u|--include-untracked] [-a|--all] [<message>]  

# 存儲(chǔ)當(dāng)前的修改但不用提交commit  
$ git stash  
# 保存當(dāng)前狀態(tài)包括untracked的文件  
$ git stash -u  
# 展示所有stashes信息 
$ git stash list  
# 回到某個(gè)stash狀態(tài)  
$ git stash apply <stash@{n}>  
# 刪除儲(chǔ)藏區(qū)  
$ git stash drop <stash@{n}>  
# 回到最后一個(gè)stash的狀態(tài)并刪除這個(gè)stash信息  
$ git stash pop  
# 刪除所有的stash信息  
$ git stash clear  
# 從stash中拿出某個(gè)文件的修改  
$ git checkout <stash@{n}> -- <file-path> 

其實(shí)比較保險(xiǎn)的做法就是，將當(dāng)前的所有修改進(jìn)行 push 并保存到遠(yuǎn)程倉(cāng)庫(kù)里面。這樣的好處在于，可以遠(yuǎn)端備份我們的修改，不會(huì)害怕本地文件丟失等問題。等到我們需要繼續(xù)開發(fā)的時(shí)候，拉下對(duì)應(yīng)內(nèi)容，再想辦法進(jìn)行補(bǔ)救，比如使用 --amend 或者 reset 命令。 

# 將工作區(qū)和暫存區(qū)覆蓋最近一次提交  
$ git commit --amend  
$ git commit --amend -m "some_info"  
# 回退到指定版本并記錄修改內(nèi)容(--mixed)  
# 本地倉(cāng)庫(kù)覆蓋到工作區(qū)(保存回退文件內(nèi)容修改)  
$ git reset a87f328  
$ git reset HEAD~ 
$ git reset HEAD~2  
$ git reset <tag>~2  
$ git reset --mixed <commit/reference>  
# 本地倉(cāng)庫(kù)覆蓋到工作區(qū)(不保留修改直接刪除掉)  
$ git reset --soft <commit/reference>  
# 本地倉(cāng)庫(kù)覆蓋到工作區(qū)(保留修改并加到暫存區(qū))  
$ git reset --hard <commit/reference>