Git 實用指南

阿里巴巴TXD發表於2019-03-28

個人整理的一些常用的 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
複製程式碼

聊聊設計

image.png

影像來自維基百科

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
複製程式碼

附錄

  • githug, 一個專門為 git 學習路徑設計的遊戲

  • awesome-git-addons, git 命令列工具擴充套件的合集

  • git-tips, 常用使用場景和技巧集合

  • lazygit, 懶人專用的 git 命令列程式

其他用途

issue 評論

  • gitment, github issue 社會化評論外掛

  • gittalk, github issue 社會化評論外掛,感覺稍微好看一點點

相關文章