開始使用

設置身份

$ git config --global user.name "Your Name"
$ git config --global user.email "[email protected]"

注意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 "[email protected]"
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 [email protected]:robbin/robbin_site.git # 設置遠程倉庫地址(用於修改遠程倉庫地址)
git remote rm <repository>       # 刪除遠程倉庫

創建遠程倉庫

git clone --bare robbin_site robbin_site.git  # 用帶版本的項目創建純版本倉庫
scp -r my_project.git [email protected]:~      # 將純倉庫上傳到服務器上

mkdir robbin_site.git && cd robbin_site.git && git --bare init # 在服務器創建純倉庫
git remote add origin [email protected]: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備忘手冊