前端綜合能力系列之git與gitflow

山東老漢發表於2018-04-20

前言

git 最強大的就是其分支功能,但是如何分支才能更有效的提高開發效率,減少因為程式碼合併帶來的問題,需要一個分支模型來規範,其實在 git flow 出現之前,已經有分支模型理論流程,當時是根據此理論,手動的按照規範操作分支,git flow 出現之後,將一部分操作流程簡化為命令,並沒有增加新的功能,只是簡化了操作。

安裝

# 目前流行的是 avh 版本的 git-flow
# 穩定版
brew install git-flow-avh
#開發板
brew install git-flow-avh --HEAD
複製程式碼

初始化專案

# cd /pass/to/your/project
# 執行下面的命令,不需要執行 git init
git flow init
複製程式碼

分支模型

用 git flow 初始化工程目錄完成後,只能看到兩個分支(長期分支):

master 分支: 用於上線的分支,保護性分支,只包含經過測試的穩定程式碼,開發人員不能直接工作在此分支上,也不能直接提交改動到 master 分支上。

develop分支: 是開發人員進行任何新的開發的基礎分支,當開始一個新的feature 分支的時候,要從 develop 分出去;另外此分支也彙集所有的已完成的功能,等待合併到 master 分支上線。 上面兩個分支被稱為 長期分支 ,存在於專案的整個生命週期中,其他分支,是臨時性的,根據需要來建立,當完成了自己的任務後,就會被刪掉。

feature 分支: 平常的開發工作使用最頻繁的分支。

建立功能分支: 如下命令會建立一個名為”feature/” 的功能分支,該分支預設從 develop檢出,在做功能性開發的時候,檢出一個獨立的分支,是版本控制中一個重要 的原則。

# git-flow 建立 feature 分支
$ git flow feature start <branch-name>
複製程式碼

完成功能分支:

# git-flow 建立 feature 分支 
$ git flow feature finish <branch-name>
複製程式碼

該命令會把我們在當前分支的程式碼整合到‘develop’分支中去,之後,git-flow 會進行清理操作,刪除當下完成的功能分支,將分支切換到‘develop’。

release 分支:

建立 release 分支:

$ git flow release start 1.1.5
複製程式碼

當你認為現在的‘develop’分支的程式碼已經是一個成熟的 release 版本的時候,這意味著:首先它包括所有新功能和必要的修復;其二,它已經被徹底的測試過了。如果上述兩點都滿足,那就是時候建立 release 分支了。 note:release 分支是使用版本號命名的,這個命名方案會讓 Git-flow在我們完成 release 後,適當的自動去標記那些 release 提交。

完成 release 分支:

$ git flow release finish 1.1.5
複製程式碼

上述命令會完成如下一系列操作:

  • git-flow 會拉取遠端倉庫,確保目前是最新的版本。
  • release 內容會被合併到 master和develop兩個長期分支中去。這樣不僅產品程式碼是最新的,新開的功能分支也將基於最新的程式碼。
  • 為了便於識別和做歷史參考,release 提交會被標記上這個 release 的名字 清理操作,版本分支會被刪除,並且回到 develop 分支。

note: 從 Git 的角度看來,release 版本現在已經完成,依據設定,對 master的提交可能已經觸發了編譯部署流程。或者手動部署。

hotfix分支:

很多時候,當對 release版本做全面測試的時候,可能就會發現一些小錯誤,在這種情況下,git-flow會提供一個特定的hotfix工作流程。

建立 hotfix 分支:

$ git flow hotfix start bug-fixed
複製程式碼

上述命令會建立一個名為:hotfix/bug-fixed 的分支,這是對產品程式碼的修復,所以 hotfix 分支是基於 master 分支檢出的。 這也是和 release 分支最明顯的區別,release 分支是基於 develop 分支檢出的。因為不能再一個還不完全穩定的分支上對產品程式碼進行修復。 就像 release 一樣,修復這個錯誤,會直接影響到專案的版本號。

完成 hotfix分支:

$ git flow hotfix finish bug-fixed
複製程式碼

上述命令類似於釋出一個 release 版本:

  • 完成的改動會被合併到 master 中,同樣也會合併到 develop 分支中,這樣就可以確保這個錯誤不會再次出現在下一個 release 中;
  • 這個 hotfix 將會被標記起來以便於參考;
  • 當前的 hotfix 分支將會被刪除,然後切換到 develop 分支;

note: 完成 hotfix 分支之後,自動或手動啟動編譯部署流程

下圖為整體流程圖:

前端綜合能力系列之git與gitflow

總結

主要分支
master: 永遠處在即將釋出(production-ready)狀態
develop: 最新的開發狀態

輔助分支
feature: 開發新功能的分支, 基於 develop, 完成後 merge 回 develop
release: 準備要釋出版本的分支, 用來修復 bug. 基於 develop, 完成後 merge 回 develop 和 master
hotfix: 修復 master 上的問題, 等不及 release 版本就必須馬上上線. 基於 master, 完成後 merge回 master 和 develop

Git常用命令清單:

宣告:下面文字參考阮一峰老師的部落格

下圖為 git 整體流程圖:

前端綜合能力系列之git與gitflow

初始化倉庫

# 在當前目錄新建一個Git程式碼庫
$ git init

# 新建一個目錄,將其初始化為Git程式碼庫
$ git init [project-name]

# 下載一個專案和它的整個程式碼歷史
$ git clone [url]
複製程式碼

配置 Git

Git的設定檔案為 .gitconfig,它可以在使用者主目錄下(全域性配置),也可以在專案目錄下(專案配置)。

# 顯示當前的Git配置
$ git config --list

# 編輯Git配置檔案
$ git config -e [--global]

# 設定提交程式碼時的使用者資訊
$ git config [--global] user.name "[name]"
$ git config [--global] user.email "[email address]"
複製程式碼

增加刪除檔案

# 新增指定檔案到暫存區
$ git add [file1] [file2] ...

# 新增指定目錄到暫存區,包括子目錄
$ git add [dir]

# 新增當前目錄的所有檔案到暫存區
$ git add .

# 新增每個變化前,都會要求確認
# 對於同一個檔案的多處變化,可以實現分次提交
$ git add -p

# 刪除工作區檔案,並且將這次刪除放入暫存區
$ git rm [file1] [file2] ...

# 停止追蹤指定檔案,但該檔案會保留在工作區
$ git rm --cached [file]

# 改名檔案,並且將這個改名放入暫存區
$ git mv [file-original] [file-renamed]
複製程式碼

程式碼提交

# 提交暫存區到倉庫區
$ git commit -m [message]

# 提交暫存區的指定檔案到倉庫區
$ git commit [file1] [file2] ... -m [message]

# 提交工作區自上次commit之後的變化,直接到倉庫區
$ git commit -a

# 提交時顯示所有diff資訊
$ git commit -v

# 使用一次新的commit,替代上一次提交
# 如果程式碼沒有任何新變化,則用來改寫上一次commit的提交資訊
$ git commit --amend -m [message]

# 重做上一次commit,幷包括指定檔案的新變化
$ git commit --amend [file1] [file2] ...
複製程式碼

分支命令

# 列出所有本地分支
$ git branch

# 列出所有遠端分支
$ git branch -r

# 列出所有本地分支和遠端分支
$ git branch -a

# 新建一個分支,但依然停留在當前分支
$ git branch [branch-name]

# 新建一個分支,並切換到該分支
$ git checkout -b [branch]

# 新建一個分支,指向指定commit
$ git branch [branch] [commit]

# 新建一個分支,與指定的遠端分支建立追蹤關係
$ git branch --track [branch] [remote-branch]

# 切換到指定分支,並更新工作區
$ git checkout [branch-name]

# 切換到上一個分支
$ git checkout -

# 建立追蹤關係,在現有分支與指定的遠端分支之間
$ git branch --set-upstream [branch] [remote-branch]

# 合併指定分支到當前分支
$ git merge [branch]

# 選擇一個commit,合併進當前分支
$ git cherry-pick [commit]

# 刪除分支
$ git branch -d [branch-name]

# 刪除遠端分支
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]
複製程式碼

標籤命令

# 列出所有tag
$ git tag

# 新建一個tag在當前commit
$ git tag [tag]

# 新建一個tag在指定commit
$ git tag [tag] [commit]

# 刪除本地tag
$ git tag -d [tag]

# 刪除遠端tag
$ git push origin :refs/tags/[tagName]

# 檢視tag資訊
$ git show [tag]

# 提交指定tag
$ git push [remote] [tag]

# 提交所有tag
$ git push [remote] --tags

# 新建一個分支,指向某個tag
$ git checkout -b [branch] [tag]
複製程式碼

檢視資訊

# 顯示有變更的檔案
$ git status

# 顯示當前分支的版本歷史
$ git log

# 顯示commit歷史,以及每次commit發生變更的檔案
$ git log --stat

# 搜尋提交歷史,根據關鍵詞
$ git log -S [keyword]

# 顯示某個commit之後的所有變動,每個commit佔據一行
$ git log [tag] HEAD --pretty=format:%s

# 顯示某個commit之後的所有變動,其"提交說明"必須符合搜尋條件
$ git log [tag] HEAD --grep feature

# 顯示某個檔案的版本歷史,包括檔案改名
$ git log --follow [file]
$ git whatchanged [file]

# 顯示指定檔案相關的每一次diff
$ git log -p [file]

# 顯示過去5次提交
$ git log -5 --pretty --oneline

# 顯示所有提交過的使用者,按提交次數排序
$ git shortlog -sn

# 顯示指定檔案是什麼人在什麼時間修改過
$ git blame [file]

# 顯示暫存區和工作區的差異
$ git diff

# 顯示暫存區和上一個commit的差異
$ git diff --cached [file]

# 顯示工作區與當前分支最新commit之間的差異
$ git diff HEAD

# 顯示兩次提交之間的差異
$ git diff [first-branch]...[second-branch]

# 顯示今天你寫了多少行程式碼
$ git diff --shortstat "@{0 day ago}"

# 顯示某次提交的後設資料和內容變化
$ git show [commit]

# 顯示某次提交發生變化的檔案
$ git show --name-only [commit]

# 顯示某次提交時,某個檔案的內容
$ git show [commit]:[filename]

# 顯示當前分支的最近幾次提交
$ git reflog
複製程式碼

遠端同步

# 下載遠端倉庫的所有變動
$ git fetch [remote]

# 顯示所有遠端倉庫
$ git remote -v

# 顯示某個遠端倉庫的資訊
$ git remote show [remote]

# 增加一個新的遠端倉庫,並命名
$ git remote add [shortname] [url]

# 取回遠端倉庫的變化,並與本地分支合併
$ git pull [remote] [branch]

# 上傳本地指定分支到遠端倉庫
$ git push [remote] [branch]

# 強行推送當前分支到遠端倉庫,即使有衝突
$ git push [remote] --force

# 推送所有分支到遠端倉庫
$ git push [remote] --all
複製程式碼

撤銷

# 恢復暫存區的指定檔案到工作區
$ git checkout [file]

# 恢復某個commit的指定檔案到暫存區和工作區
$ git checkout [commit] [file]

# 恢復暫存區的所有檔案到工作區
$ git checkout .

# 重置暫存區的指定檔案,與上一次commit保持一致,但工作區不變
$ git reset [file]

# 重置暫存區與工作區,與上一次commit保持一致
$ git reset --hard

# 重置當前分支的指標為指定commit,同時重置暫存區,但工作區不變
$ git reset [commit]

# 重置當前分支的HEAD為指定commit,同時重置暫存區和工作區,與指定commit一致
$ git reset --hard [commit]

# 重置當前HEAD為指定commit,但保持暫存區和工作區不變
$ git reset --keep [commit]

# 新建一個commit,用來撤銷指定commit
# 後者的所有變化都將被前者抵消,並且應用到當前分支
$ git revert [commit]

# 暫時將未提交的變化移除,稍後再移入
$ git stash
$ git stash pop

複製程式碼

相關文章