常用 Git 命令清單

阮一峰發表於2015-12-09

我每天使用 Git ,但是很多命令記不住。

一般來說,日常使用只要記住下圖6個命令,就可以了。但是熟練使用,恐怕要記住60~100個命令。

常用 Git 命令清單

下面是我整理的常用 Git 命令清單。幾個專用名詞的譯名如下。

  • Workspace:工作區
  • Index / Stage:暫存區
  • Repository:倉庫區(或本地倉庫)
  • Remote:遠端倉庫

一、新建程式碼庫


# 在當前目錄新建一個Git程式碼庫
$ git init

# 新建一個目錄,將其初始化為Git程式碼庫
$ git init [project-name]

# 下載一個專案和它的整個程式碼歷史
$ git clone [url]

二、配置

Git的設定檔案為.gitconfig,它可以在使用者主目錄下(全域性配置),也可以在專案目錄下(專案配置)。


# 顯示當前的Git配置
$ git config --list

# 編輯Git配置檔案
$ git config -e [--global]

# 設定提交程式碼時的使用者資訊
$ git config [--global] user.name "[name]"
$ git config [--global] user.email "[email address]"

三、增加/刪除檔案


# 新增指定檔案到暫存區
$ git add [file1] [file2] ...

# 新增指定目錄到暫存區,包括子目錄
$ git add [dir]

# 新增當前目錄的所有檔案到暫存區
$ git add .

# 新增每個變化前,都會要求確認
# 對於同一個檔案的多處變化,可以實現分次提交
$ git add -p

# 刪除工作區檔案,並且將這次刪除放入暫存區
$ git rm [file1] [file2] ...

# 停止追蹤指定檔案,但該檔案會保留在工作區
$ git rm --cached [file]

# 改名檔案,並且將這個改名放入暫存區
$ git mv [file-original] [file-renamed]

四、程式碼提交


# 提交暫存區到倉庫區
$ git commit -m [message]

# 提交暫存區的指定檔案到倉庫區
$ git commit [file1] [file2] ... -m [message]

# 提交工作區自上次commit之後的變化,直接到倉庫區
$ git commit -a

# 提交時顯示所有diff資訊
$ git commit -v

# 使用一次新的commit,替代上一次提交
# 如果程式碼沒有任何新變化,則用來改寫上一次commit的提交資訊
$ git commit --amend -m [message]

# 重做上一次commit,幷包括指定檔案的新變化
$ git commit --amend [file1] [file2] ...

五、分支


# 列出所有本地分支
$ git branch

# 列出所有遠端分支
$ git branch -r

# 列出所有本地分支和遠端分支
$ git branch -a

# 新建一個分支,但依然停留在當前分支
$ git branch [branch-name]

# 新建一個分支,並切換到該分支
$ git checkout -b [branch]

# 新建一個分支,指向指定commit
$ git branch [branch] [commit]

# 新建一個分支,與指定的遠端分支建立追蹤關係
$ git branch --track [branch] [remote-branch]

# 切換到指定分支,並更新工作區
$ git checkout [branch-name]

# 切換到上一個分支
$ git checkout -

# 建立追蹤關係,在現有分支與指定的遠端分支之間
$ git branch --set-upstream [branch] [remote-branch]

# 合併指定分支到當前分支
$ git merge [branch]

# 選擇一個commit,合併進當前分支
$ git cherry-pick [commit]

# 刪除分支
$ git branch -d [branch-name]

# 刪除遠端分支
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]

六、標籤


# 列出所有tag
$ git tag

# 新建一個tag在當前commit
$ git tag [tag]

# 新建一個tag在指定commit
$ git tag [tag] [commit]

# 刪除本地tag
$ git tag -d [tag]

# 刪除遠端tag
$ git push origin :refs/tags/[tagName]

# 檢視tag資訊
$ git show [tag]

# 提交指定tag
$ git push [remote] [tag]

# 提交所有tag
$ git push [remote] --tags

# 新建一個分支,指向某個tag
$ git checkout -b [branch] [tag]

七、檢視資訊


# 顯示有變更的檔案
$ git status

# 顯示當前分支的版本歷史
$ git log

# 顯示commit歷史,以及每次commit發生變更的檔案
$ git log --stat

# 搜尋提交歷史,根據關鍵詞
$ git log -S [keyword]

# 顯示某個commit之後的所有變動,每個commit佔據一行
$ git log [tag] HEAD --pretty=format:%s

# 顯示某個commit之後的所有變動,其"提交說明"必須符合搜尋條件
$ git log [tag] HEAD --grep feature

# 顯示某個檔案的版本歷史,包括檔案改名
$ git log --follow [file]
$ git whatchanged [file]

# 顯示指定檔案相關的每一次diff
$ git log -p [file]

# 顯示過去5次提交
$ git log -5 --pretty --oneline

# 顯示所有提交過的使用者,按提交次數排序
$ git shortlog -sn

# 顯示指定檔案是什麼人在什麼時間修改過
$ git blame [file]

# 顯示暫存區和工作區的差異
$ git diff

# 顯示暫存區和上一個commit的差異
$ git diff --cached [file]

# 顯示工作區與當前分支最新commit之間的差異
$ git diff HEAD

# 顯示兩次提交之間的差異
$ git diff [first-branch]...[second-branch]

# 顯示今天你寫了多少行程式碼
$ git diff --shortstat "@{0 day ago}"

# 顯示某次提交的後設資料和內容變化
$ git show [commit]

# 顯示某次提交發生變化的檔案
$ git show --name-only [commit]

# 顯示某次提交時,某個檔案的內容
$ git show [commit]:[filename]

# 顯示當前分支的最近幾次提交
$ git reflog

八、遠端同步


# 下載遠端倉庫的所有變動
$ git fetch [remote]

# 顯示所有遠端倉庫
$ git remote -v

# 顯示某個遠端倉庫的資訊
$ git remote show [remote]

# 增加一個新的遠端倉庫,並命名
$ git remote add [shortname] [url]

# 取回遠端倉庫的變化,並與本地分支合併
$ git pull [remote] [branch]

# 上傳本地指定分支到遠端倉庫
$ git push [remote] [branch]

# 強行推送當前分支到遠端倉庫,即使有衝突
$ git push [remote] --force

# 推送所有分支到遠端倉庫
$ git push [remote] --all

九、撤銷


# 恢復暫存區的指定檔案到工作區
$ git checkout [file]

# 恢復某個commit的指定檔案到暫存區和工作區
$ git checkout [commit] [file]

# 恢復暫存區的所有檔案到工作區
$ git checkout .

# 重置暫存區的指定檔案,與上一次commit保持一致,但工作區不變
$ git reset [file]

# 重置暫存區與工作區,與上一次commit保持一致
$ git reset --hard

# 重置當前分支的指標為指定commit,同時重置暫存區,但工作區不變
$ git reset [commit]

# 重置當前分支的HEAD為指定commit,同時重置暫存區和工作區,與指定commit一致
$ git reset --hard [commit]

# 重置當前HEAD為指定commit,但保持暫存區和工作區不變
$ git reset --keep [commit]

# 新建一個commit,用來撤銷指定commit
# 後者的所有變化都將被前者抵消,並且應用到當前分支
$ git revert [commit]

# 暫時將未提交的變化移除,稍後再移入
$ git stash
$ git stash pop

十、其他


# 生成一個可供釋出的壓縮包
$ git archive

(完)