Skip to main content

Git 基礎操作

一分鐘入門只說明如何提交檔案，但是在版本之間切換才是版本管理工具的精華，接下來的本文和下一篇文章分別為基礎操作（單一分支）和分支操作（多分支），快速檢索的方式是從右側目錄快速定位操作內容，例如提交錯誤時可以找到「清除提交」定位到 git reset。

基礎操作包含以下指令，文章中會介紹如何更靈活的 add/commit 檔案，以及復原檔案。

git add                              # 預存檔案
git commit                           # 提交檔案
git reset                            # 清除提交狀態
git checkout                         # 檔案還原的舊版指令，本文不介紹
git restore                          # 檔案還原的新版指令
git reflog                           # git 操作救命稻草

新增檔案 git add​

git add 使用 <pathspec> 來指定檔案，可以輕鬆的區分檔案，例如

git add *.py                         # 追蹤目前資料夾第一層的所有 py 檔
git add **/*.py                      # 追蹤所有 py 檔
git add src/**/*.py                  # 追蹤 src 資料夾中的所有 py 檔

除了此之外兩個方便的指令：

  • -u: 只預存已追蹤的檔案。
  • -p: 補丁模式，互動式加入預存，常用選項為
    • y, yes
    • n, no
    • d, 該檔案之後都不要加入
    • s, 切成更小的區塊 (hunk)
    • 不太需要用補丁模式，改用 lazygit 完成相同功能方便一百倍

看不懂 pathspec？請見看懂文檔。

略過特定副檔名的檔案​

# 方法一：使用表達式  
git add . ':!*.txt' ':!*.py'

# 方法二：使用 git reset
git add .                            # 預存全部檔案
git reset '*.txt' '*.py'

提交檔案 git commit​

  • git commit -am <message>: 懶人指令，略過 git add .。
  • git commit -m "<Title><按兩下Enter>: 提交有標題的 commit message 的方式，打好標題後按兩次 enter，到第三行繼續寫內容。

修改上一次提交​

常常會提交完成後馬上發現訊息寫錯、程式 typo，要怎麼修改？

直接修改現在的檔案內容並且使用下列指令可以完成，amend 的意思是修復（複寫）最近一次的提交

  • git commit --amend: 修改上次的提交訊息和檔案。
  • git commit --amend --no-edit: 修改上次的提交檔案，訊息不變。

還原檔案 git restore​

git restore [<options>] <pathspec>

用於檔案還原，只會回復檔案內容不會修改提交歷史，常用參數有三個，分別是

  • -s, --source: 指定恢復的提交來源。
  • -S, --staged: 還原已預存的檔案（白話文：取消 add 或稱作 unstage）。
  • -W --worktree: 還原到工作目錄（白話文：還原檔案在工作目錄（硬碟）的狀態）。預設開啟，但是使用 -S 時會關閉，原因是讓你可以只取消預存而不是連檔案修改都還原了。
為什麼用新版 git restore 不用舊版 checkout？

因為舊版本用於檔案還原的指令混雜，例如 git reset <pathspec> 可以指定檔案踢出預存，但是 git reset --hard 卻不能指定檔案；而 git checkout -- . 可以還原未預存的檔案，卻又不能處理已預存的檔案。

如果 checkout 已經用的很熟練繼續用當然也沒問題。

放棄未預存的程式碼​

git restore <pathspec>

放棄程式碼，不管是否預存​

git restore -SW <pathspec>

查看舊版的檔案​

git restore --source=<hash> <pathspec>

清除提交 git reset​

git reset [<mode>] [<commit>] [<pathspec>]

用於清除提交版本，reset 雖然聽起來是重設/還原，但實際做的是清除提交，預設模式是 mixed，預設檔案是全部檔案。三種模式分別是代表

  1. soft: 只清除 commit，其他不動
  2. mixed: 清除 commit 和 add
  3. hard: 除了 commit 和 add 以外，連你的寫的程式都刪了，謹慎使用！

這個指令不常用，因為他的使用場景大部分都可被互動式變基取代，不過還是提供幾個使用情境方便記憶。

程式改壞了想回復到遠端版本​

git reset --hard origin/main

origin 代表遠端別名，main 是遠端分支名稱，這是 reset 最常用的情境，下方幾個都不常用。

不小心提交，想繼續編輯​

git reset --soft HEAD^    # 清除前一個提交
git reset --soft HEAD~3   # 清除前三個提交

這個指令會取消最新的提交，但保留所有程式碼修改，使用 git commit --amend 也可達成相同效果（但是 amend 僅限最近一次提交）。

資訊
  1. HEAD 代表目前工作的 commit 位置
  2. "^" 代表前一個提交，"~n" 代表前 n 個提交

放棄未提交的修改​

結束測試性的修改後，直接回到上一次提交，這會連程式碼全部刪除，需要謹慎使用。

# 等同於 git restore -SW .
git reset --hard HEAD

提交了多個小變更，想整理成一個提交​

git reset HEAD~3

這會移除最近的三個提交，清除後再重新 add commit 為一個新提交。

這個情境用 reset 雖然做的到但是很麻煩，請用互動式變基指令，下方會介紹。

補充說明​

reset 指令不常用，原因是這些情境都能被更方便的互動式變基 (interactive rebase) 取代，最常用的應該只有從遠端還原。

危險

雖然初學暫時不會碰到多人合作，但還是必須強調修改提交歷史 永遠只該用於個人分支！

任意修改 git rebase​

git rebase 實際上是對分支進行操作，原本應該放在後續文章，但是單純進行這裡要講的互動式變基 (interactive rebase) 時你完全感受不到分支操作，而他的功能之強大值得放在這裡，請見我寫的教學 使用互動式變基 Interactive Rebase 任意修改提交歷史。

注意 rebase 本質也是在修改提交歷史，而修改提交歷史永遠只該用於個人分支。

救命稻草 git reflog​

當操作錯誤時，git 的日誌功能 git reflog 可以還原操作。直接講使用方法：

$ git reflog
5293902 (HEAD -> main, origin/main, origin/HEAD) HEAD@{0}: commit: add article: python/regex
62b2d38 HEAD@{1}: rebase (finish): returning to refs/heads/main
62b2d38 HEAD@{2}: rebase (reword): add tags to article
72c5477 HEAD@{3}: rebase (start): checkout HEAD~2
37334c5 HEAD@{4}: commit: add: article tags  # <-- 現在想還原到這個修改

$ git reset --hard HEAD@{4}

這樣會回到 rebase 前的狀態。reflog 只會紀錄本地操作，推送到遠端再 clone 下來後不會有 reflog 紀錄，所以為你自己學 Git 的這篇文章寫錯了。

結語​

到這邊就結束單一分支的操作，你已經可以基本的操作 Git 了，下一篇文章會介紹多分支操作。在初學階段個人使用時不太會用到分支功能，根據需求可以快轉到遠端儲存庫設定。