建立 2024-01-01 更新 2026-09-15

git mv

git mv 重新命名（或移動）Git 已追蹤的檔案，並自動把這個變更放進暫存區。效果等於「改檔名 + git add 新路徑 + git rm 舊路徑」。

基本用法

git mv <舊檔名> <新檔名>

例如：

git mv oldfile.txt newfile.txt

影響的區域

立刻改 workspace 與 staging，commit 後寫入 local。歷史裡 Git 通常能把改名前後視為同一檔的延續。

也可以手動改名

在檔案總管改名後：

git add <新檔名>
git add -u <舊檔名>

但 git mv 一步完成，比較不容易漏 add。

記得提交：

git commit -m "重新命名檔案 oldfile.txt 為 newfile.txt"