常用 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 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 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 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 --follow [file]

$ git whatchanged [file]

# 顯示指定檔案相關的每一次diff

$ git log -p [file]

# 顯示指定檔案是什麼人在什麼時間修改過

$ git blame [file]

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

$ git diff

# 顯示暫存區和上一個commit的差異

$ git diff --cached [file]

# 顯示工作區與目前分支最新commit之間的差異

$ git diff HEAD

# 顯示兩次送出之間的差異

$ git diff [first-branch]...[second-branch]

# 顯示某次送出的中繼資料和内容變化

$ 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]

# 恢複上一個commit的所有檔案到工作區

$ 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 archive