Git 實用指南

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

精簡入門

1、克隆倉庫

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

git clone [<options>] [--] <repo> [<dir>]

# 克隆完整的倉庫到 ./git-learning 目錄下
git clone [email protected]:x-cold/git-learning.git
# 隻克隆 dev 分支到 ./dev 目錄下
git clone -b dev [email protected]: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 [email protected]: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