git commit --amend 詳解：修改提交記錄的正確方式

git commit --amend 用于修改最近一次的提交，它通常用于：

1. 修正提交信息（如提交說明寫錯了）
2. 補充遺漏的更改（如忘記添加某些文件）
3. 合并當前更改到上一次提交

1. 修改提交信息

如果你提交后發現 commit message（提交說明）寫錯了，可以用 --amend 進行修改：

git commit --amend -m "新的提交說明"

示例：

git commit --amend -m "修正錯別字，添加更準確的描述"

這不會創建新的提交，而是直接修改上一次提交的說明。

2. 補充遺漏的文件

如果你提交后才發現少提交了某些文件，可以先 git add，然后 --amend 合并它們：

git add file1.txt file2.txt  # 先添加遺漏的文件
git commit --amend --no-edit  # 不修改提交信息，只合并更改

示例：

git add README.md
git commit --amend --no-edit

這樣，README.md 的更改會被追加到上次提交，而提交信息保持不變。

3. 結合 --amend 進行交互式修改

如果你想更改提交信息，同時補充新文件，可以使用：

git commit --amend

這會打開默認的文本編輯器（如 Vim），你可以在里面編輯提交說明，同時 Git 會自動合并已暫存的更改。

注意事項

1. 不要在推送到遠程倉庫后的提交上隨意使用 --amend，否則會改變提交哈希值，影響協作。
   • 如果已經推送了，可以用 git push --force 強制更新，但這可能會影響團隊的協作。
2. 適用于本地修改，如果提交已經分享給他人，最好用 git revert 而不是 --amend。

---

4. 已推送提交的修改

如果已經推送了提交，但仍然想修改，需要強制推送：

git commit --amend -m "修改后的提交信息"
git push --force  # 強制推送（謹慎使用）

? 警告： 強制推送可能會覆蓋遠程分支的歷史，影響其他開發者的工作，使用時需謹慎！

總結

• git commit --amend -m "新信息" → 修改提交說明
• git commit --amend --no-edit → 追加文件但不修改提交說明
• git commit --amend → 交互式修改提交

這個命令在修正錯誤時非常有用，但使用時要注意影響，尤其是在團隊協作中。