Git Guide: How to amend your most recent Git commit message

Often, the occasion will arise where the last commit was submitted prematurely (missing a file, missing a change in a file, etc.) or the commit message may have been mistyped or incomplete. For just such an occasion Git offers the --amend commit flag. To amend a commit, start by typing:

git commit --amend

The above will commit any additional changes and open your editor, allowing you to change the commit message of the most recent commit. Additionally, you can set the commit message directly in the command line with:

git commit --amend -m "New commit message"

If you want to add files or changes to the commit, you just need to ensure that the changes are added to staging with git add before running the command. Further, if you want to add all watched, modified files (in staging or otherwise) and change the commit, you can use:

git commit --amend -am "New commit message"

The -a flag says to add all files that Git has told to track.

Amending a commit after pushing to remote

When using the --amend flag, Git will replace the last commit with the new one commit complete with a new hash. This means that if you have already pushed to the remote before amending, then the old commit will be missing from any subsequent pushes, and any new push will be rejected. The way around this is to --force the push. NOTE: --force should not be done lightly. To do so, type:

git push <remote> <branch> --force

Or

git push <remote> <branch> -f

Force-pushing will overwrite the remote branch with the state of your local one. If there are commits on the remote branch that you don’t have in your local branch, you will lose them. This can cause problems if others have already pulled or cloned from your repo. If you believe others may have already downloaded the amended commit, please coordinate with them.

See Also

2 Likes