GIT備忘手冊

開始使用

設置身份

$ git config --global user.name "Your Name"
$ git config --global user.email "email@example.com"

注意git config命令的--global參數，用了這個參數，表示你這臺機器上全部的Git倉庫都會使用這個配置，固然也能夠對某個倉庫指定不一樣的用戶名和Email地址，不使用--global參數便可。

push到遠程倉庫

• 建立倉庫

經過git init命令把這個目錄變成Git能夠管理的倉庫，會在當前目錄下生成一個.git的目錄。

$ git init

• 添加到暫存區

用命令git add <file>告訴Git，把文件添加到倉庫,可反覆屢次使用，添加多個文件：

<!--指定文件-->
$ git add file2.txt file3.txt

<!--當前目錄所有文件-->
$ git add .

• 提交到本地倉庫

用命令git commit -m <message>告訴Git，把文件提交到倉庫

$ git commit -m "wrote a readme file"

• 推送到遠程倉庫

<!-- 添加遠程倉庫需使用以下命令設置，已添加則不需設置 -->
$ git remote add origin <name> <url>
<!-- 推送到遠程倉庫 -->
$ git push <name>
git push -u origin master

經常使用命令速查

全局配置

git config --global user.name "robbin"
git config --global user.email "fankai@gmail.com"
git config --global color.ui true    # 讓Git顯示顏色
git config --global alias.co checkout  # 設置別名
git config --global alias.ci commit
git config --global alias.st status
git config --global alias.br branch
git config --global core.editor "mate -w"    # 設置Editor使用textmate
git config -l  # 列舉全部配置
git config --global credential.helper store   # 記住賬號密碼，不用每次驗證

用戶的git配置文件~/.gitconfig

經常使用命令

• 查看、添加、提交、刪除、找回，重置修改文件

git help <command>  # 顯示command的help
git show            # 顯示某次提交的內容
git show $id

git co  -- <file>   # 拋棄工做區修改
git co  .           # 拋棄工做區修改

git add <file>      # 將工做文件修改提交到本地暫存區
git add .           # 將全部修改過的工做文件提交暫存區

git rm <file>       # 從版本庫中刪除文件
git rm <file> --cached  # 從版本庫中刪除文件，但不刪除文件

git reset <file>    # 從暫存區恢復到工做文件
git reset -- .      # 從暫存區恢復到工做文件
git reset --hard    #

• 恢復最近一次提交過的狀態，即放棄上次提交後的全部本次修改

git ci <file>
git ci .
git ci -a           # 將git add, git rm和git ci等操做都合併在一塊兒作
git ci -am "some comments"
git ci --amend      # 修改最後一次提交記錄

git revert <$id>    # 恢復某次提交的狀態，恢復動做自己也建立了一次提交對象
git revert HEAD     # 恢復最後一次提交的狀態

• 查看文件diff

git diff <file>     # 比較當前文件和暫存區文件差別
git diff
git diff <$id1> <$id2>   # 比較兩次提交之間的差別
git diff <branch1>..<branch2> # 在兩個分支之間比較
git diff --staged   # 比較暫存區和版本庫差別
git diff --cached   # 比較暫存區和版本庫差別
git diff --stat     # 僅僅比較統計信息

• 查看提交記錄

git log
git log --graph --pretty=oneline --abbrev-commit
git log <file>      # 查看該文件每次提交記錄
git log -p <file>   # 查看每次詳細修改內容的diff
git log -p -2       # 查看最近兩次詳細修改內容的diff
git log --stat      # 查看提交統計信息
# tig Mac上可使用tig代替diff和log，brew install tig

Git 本地分支管理

• 查看、切換、建立和刪除分支

git br -r           # 查看遠程分支
git br <new_branch> # 建立新的分支
git br -v           # 查看各個分支最後提交信息
git br --merged     # 查看已經被合併到當前分支的分支
git br --no-merged  # 查看還沒有被合併到當前分支的分支

git checkout <branch>     # 切換到某個分支
git checkout -b <new_branch> # 建立新的分支，而且切換過去
git checkout -b <new_branch> <branch>  # 基於branch建立新的new_branch

git checkout $id          # 把某次歷史提交記錄checkout出來，但無分支信息，切換到其餘分支會自動刪除
git checkout $id -b <new_branch>  # 把某次歷史提交記錄checkout出來，建立成一個分支

git br -d <branch>  # 刪除某個分支
git br -D <branch>  # 強制刪除某個分支 (未被合併的分支被刪除的時候須要強制)

• 分支合併和rebase

git merge <branch>               # 將branch分支合併到當前分支
git merge origin/master --no-ff  # 不要Fast-Foward合併，這樣能夠生成merge提交

git rebase master <branch>       # 將master rebase到branch，至關於：
git checkout <branch> && git rebase master && git co master && git merge <branch>

• Git遠程分支管理

git pull                         # 抓取遠程倉庫全部分支更新併合併到本地
git pull --no-ff                 # 抓取遠程倉庫全部分支更新併合併到本地，不要快進合併
git branch --set-upstream-to=origin/dev dev   # 將本地分支與遠程分支關聯
git fetch origin                 # 抓取遠程倉庫更新
git merge origin/master          # 將遠程主分支合併到本地當前分支
git checkout --track origin/branch     # 跟蹤某個遠程分支建立相應的本地分支
git checkout -b <local_branch> origin/<remote_branch>  # 基於遠程分支建立本地分支，功能同上

git push                         # push全部分支
git push origin master           # 將本地主分支推到遠程主分支
git push -u origin master        # 將本地主分支推到遠程(如無遠程主分支則建立，用於初始化遠程倉庫)
git push origin <local_branch>   # 建立遠程分支， origin是遠程倉庫名
git push origin <local_branch>:<remote_branch>  # 建立遠程分支
git push origin :<remote_branch>  #先刪除本地分支(git br -d <branch>)，而後再push刪除遠程分支

Git補丁管理(方便在多臺機器上開發同步時用)

git diff > ../sync.patch         # 生成補丁
git apply ../sync.patch          # 打補丁
git apply --check ../sync.patch  # 測試補丁可否成功

Git標籤管理

通常發佈版本能夠採用標籤形式來建立里程碑。

注意：標籤老是和某個commit掛鉤。若是這個commit既出如今master分支，又出如今dev分支，那麼在這兩個分支上均可以看到這個標籤。

git tag           # 查看全部標籤
git tag v1.0.0    # 從當前建立標籤
git tag v1.0.0 <commitId>  # 從某個commitId建立標籤
git tag -a v0.1 -m "version 0.1 released" 1094adb   # 建立帶有說明的標籤
git show <tagname>    # 查看標籤信息
git tag -d v0.1       # 刪除標籤
git push origin <tagname>  # 推送某個標籤到遠程
git push origin --tags   # 推送所有還沒有推送到遠程的本地標籤
# 刪除遠程分支須要兩步：
git tag -d <tagname>   # 1.刪除本地標籤
git push origin :refs/tags/<tagname>   # 2.刪除遠程標籤

Git儲藏管理

git stash                        # 暫存
git stash list                   # 列全部stash
git stash apply  [stashName]               # 恢復儲藏的內容
git stash drop                   # 刪除儲藏區
git stash pop                   # 恢復並刪除儲藏內容
git stash clear               # 清空儲藏區

Git遠程倉庫管理

git remote -v                    # 查看遠程服務器地址和倉庫名稱
git remote show origin           # 查看遠程服務器倉庫狀態
git remote add origin git@github:robbin/robbin_site.git         # 添加遠程倉庫地址
git remote set-url origin git@github.com:robbin/robbin_site.git # 設置遠程倉庫地址(用於修改遠程倉庫地址)
git remote rm <repository>       # 刪除遠程倉庫

• 建立遠程倉庫

git clone --bare robbin_site robbin_site.git  # 用帶版本的項目建立純版本倉庫
scp -r my_project.git git@git.csdn.net:~      # 將純倉庫上傳到服務器上

mkdir robbin_site.git && cd robbin_site.git && git --bare init # 在服務器建立純倉庫
git remote add origin git@github.com:robbin/robbin_site.git    # 設置遠程倉庫地址
git push -u origin master                                       # 客戶端首次提交
git push -u origin develop  # 首次將本地develop分支提交到遠程develop分支，而且track

git remote set-head origin master   # 設置遠程倉庫的HEAD指向master分支
# 也能夠命令設置跟蹤遠程庫和本地庫
git branch --set-upstream master origin/master
git branch --set-upstream develop origin/develop

分支模型管理策略

master 分支

• master 爲主分支，也是用於部署生產環境的分支，確保master分支穩定性。
• master 分支通常由develop以及hotfix分支合併而來，任什麼時候候都不能直接修改該分支的代碼。

develop分支

• develop 爲開發分支，始終保持最新完成以及bug修復後的代碼。
• 通常開發的新功能時，建立的feature分支都是基於develop分支的。

feature 分支

• 開發新功能時，以develop爲基礎建立feature分支。
• 分支命名: feature/開頭的爲特性分支， 命名如: feature/user_module、 feature/cart_module。

release分支

• release爲預上線分支，發佈提測階段，會以release分支代碼爲基準提測。
• 當有一組feature開發完成，首先會合併到develop分支，進入提測時，會建立release分支。若是測試過程當中若存在bug須要修復，則直接由開發者在release分支修復並提交。當測試完成以後，合併release分支到master和develop分支，此時master爲最新代碼，用做上線。

hotfix 分支

• 分支命名: hotfix/ 開頭的爲修復分支，它的命名規則與 feature 分支相似。
• 線上出現緊急問題時，須要及時修復，以master分支爲基線，建立hotfix分支，修復完成後，須要合併到master分支和develop分支。

其中master和develop分支爲常設分支，遠程倉庫中也應包含這兩個分支；其餘的爲臨時性分支，使用完成後應該刪除，也建議不要推送到遠程倉庫。

具體規範參考：Git分支管理策略

GIT 提交規範推薦

GIT提交時的粒度應該是一個小功能點或者一個bugFix，這樣進行恢復操做時可以將影響範圍降到最低。

爲了方便跟蹤工程歷史，編寫良好的版本發佈日誌，咱們應該編寫一個良好的commit messages。建議採用當前普遍應用的 Angular Git CommitGuidelines規範。

每次提交，Commit message 能夠包括三個部分：Header，Body 和 Footer。

<type>(<scope>): <subject>  // header
// 空一行
<body>
// 空一行
<footer>

其中，Header 是必需的，Body 和 Footer 能夠省略。不論是哪個部分，任何一行都不得超過72個字符（或100個字符），這是爲了不自動換行影響日誌查閱。

Header

Header部分只有一行，包括三個字段：type（必需）、scope（可選）和subject（必需）。

Type

type用於說明 commit 的類別，只容許使用下面7個標識。

• feat：新功能（feature）
• fix：修補bug
• docs：文檔（documentation）
• style： 格式（不影響代碼運行的變更）
• refactor：重構（即不是新增功能，也不是修改bug的代碼變更）
• test：增長測試
• chore：構建過程或輔助工具的變更

若是type爲feat和fix，則該 commit 將確定出如今 ChangeLog 之中。其餘狀況，如：docs、chore、style、refactor、test，根據實際狀況決定是否放入 ChangeLog，建議不放入。

Scope

scope用於說明 commit 影響的範圍，好比數據層、控制層、視圖層等等，視項目不一樣而不一樣，本項目建議採用模塊區分，如：模版編輯、數據更新。

Subject

subject是 commit 目的的簡短描述，不超過50個字符；以動詞開頭，使用第一人稱如今時，好比change，而不是changed或changes；第一個字母小寫，結尾不加句號。

Body

Body 部分是對本次 commit 的詳細描述，能夠分紅多行。

Footer

Footer 部分只用於不兼容變更或關閉 Issue。

---

參考資料：

• Git官方使用說明
• Git教程-廖雪峯