Git Cheatsheet

Git 指令速查手冊,依情境分類快速查找。

初始化與設定

git init

在目前目錄初始化新的 Git 儲存庫

git clone <url>

將遠端儲存庫複製到本地端

git clone <url> <dir>

將遠端儲存庫複製到指定目錄

git config --global user.name "名字"

設定全域使用者名稱

git config --global user.email "邮箱"

設定全域電子郵件

git config --list

查看所有設定資訊

git config --global alias.co checkout

設定指令別名

基本操作

git status

查看工作區與暫存區狀態

git add <file>

將檔案加入暫存區

git add .

將所有修改加入暫存區

git add -p

以互動方式選擇要暫存的修改

git commit -m "消息"

提交暫存區的修改

git commit -am "消息"

加入並提交已追蹤檔案的修改

git commit --amend

修改最近一次提交

git commit --amend --no-edit

修改最近一次提交但不變更訊息

分支管理

git branch

列出本地端分支

git branch -a

列出所有分支(含遠端)

git branch <name>

建立新分支

git branch -d <name>

刪除已合併的分支

git branch -D <name>

強制刪除分支

git checkout <branch>

切換到指定分支

git checkout -b <name>

建立並切換到新分支

git switch <branch>

切換分支(新指令)

git switch -c <name>

建立並切換到新分支(新指令)

git merge <branch>

將指定分支合併到目前分支

git merge --no-ff <branch>

以非快轉方式合併(保留合併記錄)

git rebase <branch>

變基:將目前分支變基到目標分支

git rebase -i <commit>

互動式變基

遠端操作

git remote -v

查看遠端儲存庫資訊

git remote add origin <url>

新增遠端儲存庫

git remote set-url origin <url>

修改遠端儲存庫 URL

git fetch

從遠端取得最新資訊(不合併)

git fetch --all

取得所有遠端儲存庫的最新資訊

git pull

拉取遠端更新並合併

git pull --rebase

拉取遠端更新並變基

git push

將本地端提交推送到遠端

git push -u origin <branch>

推送並設定上游分支

git push origin --delete <branch>

刪除遠端分支

git push --force

強制推送(請謹慎使用)

查看歷史

git log

查看提交歷史

git log --oneline

以精簡模式查看提交歷史

git log --graph --oneline

以圖形方式查看分支合併歷史

git log -n <num>

查看最近 N 筆提交

git log --author="名字"

依作者篩選提交

git log --since="2 weeks ago"

依時間篩選提交

git log -p <file>

查看指定檔案的提交歷史與差異

git blame <file>

查看檔案每一列的最後修改資訊

git diff

查看工作區與暫存區的差異

git diff --staged

查看暫存區與上次提交的差異

git diff <branch1> <branch2>

查看兩個分支的差異

git show <commit>

查看某次提交的詳細資訊

復原與回復

git restore <file>

復原工作區修改(新指令)

git restore --staged <file>

取消暫存(新指令)

git checkout -- <file>

復原工作區修改(舊指令)

git reset HEAD <file>

取消暫存(舊指令)

git reset --soft <commit>

回復到指定提交,將修改保留在暫存區

git reset --mixed <commit>

回復到指定提交,將修改保留在工作區

git reset --hard <commit>

回復到指定提交,捨棄所有修改

git revert <commit>

建立新提交來復原指定提交

git revert -n <commit>

復原但不自動提交

git clean -fd

刪除未追蹤的檔案與目錄

git clean -fdn

預覽將刪除的未追蹤檔案

暫存與貯藏

git stash

暫存目前的修改

git stash save "描述"

暫存並加上描述

git stash list

查看所有暫存

git stash pop

還原最近一次暫存並刪除

git stash apply

還原最近一次暫存但不刪除

git stash apply stash@{n}

還原指定暫存

git stash drop stash@{n}

刪除指定暫存

git stash clear

刪除所有暫存

git stash branch <name>

以暫存為基礎建立新分支

標籤管理

git tag

列出所有標籤

git tag <name>

建立輕量標籤

git tag -a <name> -m "消息"

建立附註標籤

git tag <name> <commit>

為指定提交加上標籤

git tag -d <name>

刪除本地端標籤

git push origin <tag>

將標籤推送到遠端

git push origin --tags

將所有標籤推送到遠端

git push origin --delete tag <name>

刪除遠端標籤

進階操作

git cherry-pick <commit>

將指定提交套用到目前分支

git cherry-pick <c1>..<c2>

將多個提交套用到目前分支

git reflog

查看所有操作記錄(可用於還原遺失的提交)

git bisect start

啟動二分搜尋以定位 Bug

git bisect good <commit>

標記為正常提交

git bisect bad <commit>

標記為有問題的提交

git worktree add <dir> <branch>

建立工作樹(多分支同時作業)

git submodule add <url>

新增子模組

git submodule update --init

初始化並更新子模組

使用說明

指令分類

本速查手冊依使用情境將 Git 指令分為九大類:初始化與設定、基本操作、分支管理、遠端操作、查看歷史、復原與回復、暫存與貯藏、標籤管理、進階操作,方便依情境快速定位

搜尋功能

頂端搜尋框支援依指令文字或描述進行模糊比對(採用 Fuse.js),輸入關鍵字後會自動在所有分類中篩選包含符合指令的分類,沒有符合指令的分類會被隱藏

複製指令

!滑鼠移至指令列上時,右側會出現複製按鈕,點選即可將完整指令複製到剪貼簿,複製成功後會在右上角顯示提示。指令中帶尖括號的預留位置(如 <file>、<url>)需替換為實際值後再使用