日常 Git 工作流程
多數工作都遵循相同的循環:查看狀態、用 git add 暫存變更、用 git commit 記錄變更,再用 git push 分享出去。分支則讓尚未完成的工作與主線分開。
標有警告的指令會捨棄變更或改寫歷史。請謹慎使用,尤其是在其他人已經 pull 過的分支上。
可搜尋的日常 Git 指令清單,涵蓋設定、暫存、分支、遠端、復原變更與歷史紀錄,並標示具破壞性的指令。
git config --global user.name "Your Name"設定提交中記錄的名稱。
git config --global user.email "[email protected]"設定提交中記錄的電子郵件地址。
git init在目前資料夾建立新的儲存庫。
git clone <url>下載儲存庫及其完整歷史。
git status顯示已變更、已暫存與未追蹤的檔案。
git add <file>將檔案加入暫存,準備下一次提交。
git add -A暫存所有變更,包括已刪除的檔案。
git add -p以互動方式選擇要暫存哪些部分的變更。
git commit -m "message"將已暫存的變更記錄為新的提交。
git commit --amend以新的訊息或額外變更取代上一次提交。
會捨棄變更或改寫歷史git diff顯示尚未暫存的變更。
git diff --staged顯示已暫存、將納入下一次提交的變更。
git branch列出本地分支;目前所在分支會以 * 標示。
git switch -c <branch>建立新分支並切換過去。
git switch <branch>切換到既有的分支。
git merge <branch>將另一個分支合併到目前分支。
git rebase <branch>將您的提交重新套用到另一個分支之上。
會捨棄變更或改寫歷史git branch -d <branch>刪除已合併的本地分支。
git remote add origin <url>以 origin 為名稱連結遠端儲存庫。
git fetch --prune下載遠端變更,並清除遠端已刪除分支的本地參照。
git pull取得遠端變更並整合到目前分支。
git push將本地提交上傳到遠端分支。
git push -u origin <branch>推送新分支並與遠端分支建立連結。
git restore <file>捨棄檔案中尚未暫存的變更。
會捨棄變更或改寫歷史git restore --staged <file>取消檔案的暫存,但保留其變更。
git revert <commit>建立新的提交來復原先前的提交。
git reset --soft HEAD~1復原上一次提交,但將其變更保留在暫存狀態。
會捨棄變更或改寫歷史git reset --hard <commit>將分支移到某個提交,並捨棄所有本地變更。
會捨棄變更或改寫歷史git log --oneline --graph以分支圖顯示精簡的歷史紀錄。
git show <commit>顯示某次提交的訊息與變更內容。
git blame <file>顯示檔案每一行最後由誰修改。
git reflog列出最近的 HEAD 位置,以救回遺失的提交。
git stash儲存尚未提交的變更,並清空工作目錄。
git stash pop重新套用最新的 stash,並將其從清單中移除。
git stash list列出所有已儲存的 stash。
| 指令 | 用途 |
|---|---|
git config --global user.name "Your Name" | 設定提交中記錄的名稱。 |
git config --global user.email "[email protected]" | 設定提交中記錄的電子郵件地址。 |
git init | 在目前資料夾建立新的儲存庫。 |
git clone <url> | 下載儲存庫及其完整歷史。 |
git status | 顯示已變更、已暫存與未追蹤的檔案。 |
git add <file> | 將檔案加入暫存,準備下一次提交。 |
git add -A | 暫存所有變更,包括已刪除的檔案。 |
git add -p | 以互動方式選擇要暫存哪些部分的變更。 |
git commit -m "message" | 將已暫存的變更記錄為新的提交。 |
git commit --amend | 以新的訊息或額外變更取代上一次提交。 會捨棄變更或改寫歷史 |
git diff | 顯示尚未暫存的變更。 |
git diff --staged | 顯示已暫存、將納入下一次提交的變更。 |
git branch | 列出本地分支;目前所在分支會以 * 標示。 |
git switch -c <branch> | 建立新分支並切換過去。 |
git switch <branch> | 切換到既有的分支。 |
git merge <branch> | 將另一個分支合併到目前分支。 |
git rebase <branch> | 將您的提交重新套用到另一個分支之上。 會捨棄變更或改寫歷史 |
git branch -d <branch> | 刪除已合併的本地分支。 |
git remote add origin <url> | 以 origin 為名稱連結遠端儲存庫。 |
git fetch --prune | 下載遠端變更,並清除遠端已刪除分支的本地參照。 |
git pull | 取得遠端變更並整合到目前分支。 |
git push | 將本地提交上傳到遠端分支。 |
git push -u origin <branch> | 推送新分支並與遠端分支建立連結。 |
git restore <file> | 捨棄檔案中尚未暫存的變更。 會捨棄變更或改寫歷史 |
git restore --staged <file> | 取消檔案的暫存,但保留其變更。 |
git revert <commit> | 建立新的提交來復原先前的提交。 |
git reset --soft HEAD~1 | 復原上一次提交,但將其變更保留在暫存狀態。 會捨棄變更或改寫歷史 |
git reset --hard <commit> | 將分支移到某個提交,並捨棄所有本地變更。 會捨棄變更或改寫歷史 |
git log --oneline --graph | 以分支圖顯示精簡的歷史紀錄。 |
git show <commit> | 顯示某次提交的訊息與變更內容。 |
git blame <file> | 顯示檔案每一行最後由誰修改。 |
git reflog | 列出最近的 HEAD 位置,以救回遺失的提交。 |
git stash | 儲存尚未提交的變更,並清空工作目錄。 |
git stash pop | 重新套用最新的 stash,並將其從清單中移除。 |
git stash list | 列出所有已儲存的 stash。 |
多數工作都遵循相同的循環:查看狀態、用 git add 暫存變更、用 git commit 記錄變更,再用 git push 分享出去。分支則讓尚未完成的工作與主線分開。
標有警告的指令會捨棄變更或改寫歷史。請謹慎使用,尤其是在其他人已經 pull 過的分支上。
Git 很少會永久遺失已提交的工作。
git switch(於 Git 2.23 加入)只負責切換分支,而 git checkout 還能還原檔案。switch 與 restore 將這兩項工作拆開,以降低出錯的機率。
merge 會完整保留歷史,在共用分支上最安全。rebase 能產生更乾淨的線性歷史,但會改寫提交,因此只對沒有其他人使用的分支進行 rebase。
它會從遠端下載新的提交,並移除遠端已刪除分支的本地參照。