Git 實用指南

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

精簡入門

一、克隆倉庫

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

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

二、將文件變動記錄寫入到本地的索引庫

git add [<options>] [--] <pathspec>...

# 添加當前目錄下全部文件
git add .
# 添加部分文件
git add src/ app/ index.js

三、提交變動到工做區

git commit [<options>] [--] <pathspec>...

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

四、推送代碼到遠程倉庫

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 倉庫。

一、查看遠程倉庫信息

git remote

二、看遠程倉庫詳細信息

git remote -v

三、刪除遠程倉庫

git remote remove <name>

# 移除名字爲 origin 的遠程倉庫
git remote remove origin

四、添加遠程倉庫

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

一、列出本地存在的分支

git branch

二、列出遠程分支

git branch -r

三、列出本地和遠程分支

git branch -a

四、建立本地分支

git branch [branchName]  (remoteBranch)

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

五、分支重命名

git branch [<options>] (-m | -M) [<old-branch>] <new-branch>

# 修改 feature/canvas 分支名爲 feature/canvas2
git branch -M feature/canvas feature/canvas2

六、刪除本地分支

git branch -d | -D [branchName]

七、刪除遠程分支

git branch [<options>] [-r] (-d | -D) <branch-name>.

# 刪除 feature/canvas2 分支
git branch -d feature/canvas2

八、設置默認上游及分支

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

一、建立 tag

git tag -a v1.1.0 -m ""

二、查看 tag

git tag

三、推送到遠程

git push origin --tags

四、刪除本地 tag

git tag -d v1.0.0

五、刪除遠程 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 條歷史，操做步驟以下：

一、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.
#

二、編輯上述列表文件，在須要更改的 commit 前，將 pick 修改成 edit ，若是須要壓縮，可設置爲 squash 保存退出，進入到 rebase 流程；

三、經過 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

附錄

• githug, 一個專門爲 git 學習路徑設計的遊戲
• awesome-git-addons, git 命令行工具擴展的合集
• git-tips, 經常使用使用場景和技巧集合
• lazygit, 懶人專用的 git 命令行程序

其餘用途

issue 評論

• gitment, github issue 社會化評論插件
• gittalk, github issue 社會化評論插件，感受稍微好看一點點