Git 實用指南

個人整理的一些常用的 Git 概念和命令集合，方便速查和快速解決某些場景下的問題，覆蓋了日常開發和協同工作下的一部分場景，不只是命令列的介紹。歡迎關注語雀原文，持續更新！

精簡入門

1、克隆倉庫

克隆倉庫會下載倉庫完整的檔案、分支和歷史記錄。

git clone [<options>] [--] <repo> [<dir>]
複製程式碼

# 克隆完整的倉庫到 ./git-learning 目錄下
git clone git@github.com:x-cold/git-learning.git
# 只克隆 dev 分支到 ./dev 目錄下
git clone -b dev git@github.com:x-cold/git-learning.git dev
複製程式碼

2、將檔案變更記錄寫入到本地的索引庫

git add [<options>] [--] <pathspec>...
複製程式碼

# 新增當前目錄下所有檔案
git add .
# 新增部分檔案
git add src/ app/ index.js
複製程式碼

3、提交變更到工作區

git commit [<options>] [--] <pathspec>...
複製程式碼

# 最普通的提交
git commit -m "feat: support canvas"
# 修改當前的 commit message
git commit --amend
# 重置當前的 commit author 和 message
git commit --amend --reset-author 
複製程式碼

4、推送程式碼到遠端倉庫

git push [<options>] [<repository> [<refspec>...]]
複製程式碼

# 提交本地倉庫當前分支到遠端倉庫的 master 分支
git push origin master
# 提交本地倉庫 dev 分支到遠端的 master 分支
git push origin master:dev
複製程式碼

聊聊設計

影像來自維基百科

Git 是一個分散式的版本控制工具，因此遠端和本地可以視為兩個獨立的 Git 倉庫。上圖是一張經典的 Git 中的資料流與儲存級別的介紹，其中儲存級別主要包含幾部分：

工作區 (Working Files)，指的是我們時刻在編輯的檔案的目錄，通常來說我們修改檔案都是在工作區體現的
暫存區（Stage），暫存將本地的修改，然後提交到本地倉庫
本地倉庫（Local）
遠端倉庫（Remote）

由此不難看出整體的資料流動，就是一條從：工作區 -> 暫存區 -> 本地倉庫 -> 遠端倉庫的雙向資料流通道。

常用命令

git init

建立一個空白的 git 倉庫

git init
複製程式碼

git add

git add [<options>] [--] <pathspec>...
複製程式碼

git commit

git commit [<options>] [--] <pathspec>...
複製程式碼

git remote

remote 指的是本地的 git 倉庫關聯的遠端 git 倉庫。

1、檢視遠端倉庫資訊

git remote
複製程式碼

2、看遠端倉庫詳細資訊

git remote -v
複製程式碼

3、刪除遠端倉庫

git remote remove <name>
複製程式碼

# 移除名字為 origin 的遠端倉庫
git remote remove origin
複製程式碼

4、新增遠端倉庫

git remote add [-t <branch>] [-m <master>] [-f] [--tags | --no-tags] [--mirror=<fetch|push>] <name> <url>
複製程式碼

git remote origin git@github.com:x-cold/git-learning.git
複製程式碼

git branch

1、列出本地存在的分支

git branch
複製程式碼

2、列出遠端分支

git branch -r
複製程式碼

3、列出本地和遠端分支

git branch -a
複製程式碼

4、建立本地分支

git branch [branchName]  (remoteBranch)
複製程式碼

# 基於遠端倉庫的 dev 分支，建立本地倉庫的 feature/canvas 分支
git branch feature/canvas dev
複製程式碼

5、分支重新命名

git branch [<options>] (-m | -M) [<old-branch>] <new-branch>
複製程式碼

# 修改 feature/canvas 分支名為 feature/canvas2
git branch -M feature/canvas feature/canvas2
複製程式碼

6、刪除本地分支

git branch -d | -D [branchName]
複製程式碼

7、刪除遠端分支

git branch [<options>] [-r] (-d | -D) <branch-name>.
複製程式碼

# 刪除 feature/canvas2 分支
git branch -d feature/canvas2
複製程式碼

8、設定預設上游及分支

git branch --set-upstream <localBranch> <remote>/<remoteBranch>
複製程式碼

# 以後只需要在 dev 分支執行 git push (無需額外的引數) 就可以提交到 origin/dev
git branch --set-upstream dev origin/dev
複製程式碼

git checkout

檢出分支:

git checkout [<options>] <branch>
複製程式碼

# 切換當前分支到 dev 分支
git checkout dev
# 基於當前分支建立 test 分支，並且將當前分支切換到 test 分支
git checkout -b test
複製程式碼

除開用於分支切換，checkout 還可以用於恢復未新增到本地工作區，但是被修改過的檔案。
**

# 將 index.js 恢復到當前 commit 的內容
git checkout index.js
複製程式碼

git merge

合併分支:

git merge [<options>] [<commit>...]
複製程式碼

# 合併遠端倉庫的 master 分支到當前分支
git merge origin/master
複製程式碼

git rebase

變基，是一種常用且有風險的操作，會改變提交歷史，謹慎使用！

git rebase 
while(存在衝突) {
    git status
    找到當前衝突檔案，編輯解決衝突
    git add -u
    git rebase --continue
    if( git rebase --abort )
        break; 
}
複製程式碼

git cherry-pick

魔法級的命令，cherry-pick 可以提取 N 個的提交記錄，合入穩定版本的分支上。

git cherry-pick [<options>] <commit-ish>...
複製程式碼

# 挑選 371c2 單個提交記錄，合入當前分支
git cherry-pick 371c2
# 挑選出 371c2 到 971209 的所有提交記錄，併合入當前分支
git cherry-pick 371c2…971209
複製程式碼

git push

推送到遠端倉庫，同步本地倉庫的提交歷史到遠端倉庫

git push [<options>] [<repository> [<refspec>...]]
複製程式碼

# 提交本地倉庫當前分支到遠端倉庫的 master 分支
git push origin master
# 提交本地倉庫 dev 分支到遠端的 master 分支
git push origin master:dev
# 提交單個 tag
git push origin publish/1.0.0
# 提交所有 tag
git push origin --tags
複製程式碼

git pull

拉取遠端分支，同步遠端倉庫的提交歷史到本地倉庫

git pull [<options>] [<repository> [<refspec>...]]
複製程式碼

# 通常來說，預設的 pull 行為等同於 git fetch + git merge
# 下面這行命令等同於 git fetch origin master && git merge origin/master
git pull origin master

# 也可以通過變基的方式來拉取程式碼，這樣分支模型不容易受到影響
# 下面這行命令等同於 git fetch origin master && git rebase origin/master
git pull --rebase origin master
複製程式碼

git tag

1、建立 tag

git tag -a v1.1.0 -m ""
複製程式碼

2、檢視 tag

git tag
複製程式碼

3、推送到遠端

git push origin --tags
複製程式碼

4、刪除本地 tag

git tag -d v1.0.0
複製程式碼

5、刪除遠端 tag

git push origin :refs/tags/v1.0.0
複製程式碼

.git 倉庫後設資料

每一個 git 的程式碼倉庫目錄下，都會有一個 .git 的資料夾，其中包含的重要檔案包含以下：

檔案/資料夾	含義
config*	配置檔案
description	描述，僅供 Git Web 程式使用
HEAD	當前被檢出的分支
index	暫存區資訊
hooks/	客戶端或服務端的鉤子指令碼（hook scripts）
info/	全域性性排除（global exclude）檔案，不希望被記錄在 .gitignore 檔案中的忽略模式（ignored patterns）
objects/	所有資料內容
refs/	資料（分支）的提交物件的指標

進階技巧

修改 commit 歷史

使用 git rebase 進行歷史修改，假定修改最近 3 條歷史，操作步驟如下：

1、git rebase -i HEAD~3

執行此命令會提供一個提交列表，如下所示，其中 commit 記錄是時間逆序排列的；

pick f7f3f6d changed my name a bit
pick 310154e updated README formatting and added blame
pick a5f4a0d added cat-file

# Rebase 710f0f8..a5f4a0d onto 710f0f8
#
# Commands:
#  p, pick = use commit
#  e, edit = use commit, but stop for amending
#  s, squash = use commit, but meld into previous commit
#
# If you remove a line here THAT COMMIT WILL BE LOST.
# However, if you remove everything, the rebase will be aborted.
#
複製程式碼

2、編輯上述列表檔案，在需要更改的 commit 前，將 pick 修改為 edit ，如果需要壓縮，可設定為 squash 儲存退出，進入到 rebase 流程；

3、通過 git commit --amend --author 對歷史記錄依次修改和持續進行 rebase；

新增指定檔案

git ls-files src/ | grep '\.css$' | xargs git add
複製程式碼

刪除所有 commit 中的某些檔案

# 刪除檔案
git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch -r build' --prune-empty --tag-name-filter cat -- --all

# 觸發 GC
git reflog expire --expire=now --all && git gc --prune=now --aggressive
複製程式碼

git stash

使用 stash 可以將當工作區更改的臨時存放起來，等一番 git 操作（比如 merge / rebase 等）之後，再將這部分更改重新放回工作區。

# 臨時存放，臨時存放區是一個棧的結構，支援多次臨時存放，遵循後入先出的原則
git stash
# 重新放回到工作區
git stash pop
複製程式碼