Conclusion#

When uploading a Git project for the first time, set the correct user information beforehand. If you discover an incorrect Commit Email after pushing, you can use git commit --amend --reset-author to correct the most recent Commit, then safely force update the remote.

When to Use This#

• First-time upload of a local project to GitHub
• Discovering incorrect author name or email settings after a commit
• GitHub Contribution not correctly linked to the account
• Only needing to correct the author information of the “most recent commit”

Step-by-Step Process#

1
git init
2
git add .
3
git remote add origin https://github.com/user-name/project-name.git
4
git branch -M main

1
# 設定目前 Repository 的 Git 作者資訊
2
git config user.name "user-name"
3
git config user.email "user-email"
4

5
# HTTPS Credential 依完整 Repository 路徑區分
6
git config credential.useHttpPath true
7

8
# 建立第一次 Commit
9
git commit -m "Initial commit"
10

11
# 上傳到 GitHub
12
git push -u origin main

1
git config --global user.name "user-name"
2
git config --global user.email "user-email"

1
# 先設定正確作者資訊
2
git config user.name "user-name"
3
git config user.email "user-email"
4

5
# 使用目前設定重新建立最近一次 Commit 作者資訊
6
git commit --amend --reset-author --no-edit
7

8
# 確認修改結果
9
git log -1 --format="%an <%ae>"
10

11
# 更新遠端 Commit
12
git push --force-with-lease origin main

Additional Notes#

• git commit --amend generates a new Commit Hash, so a pushed commit will require a force update to the remote.
• Prioritize using -force-with-lease as it is safer than direct -force, reducing the risk of overwriting someone else’s remote updates.
• The method above only corrects the “most recent commit”; if the incorrect email exists in multiple historical commits, you’ll need to rewrite Git History, which cannot be done with a single -amend.

Command / Example Summary#

1
# 初始化專案
2
git init
3
git add .
4
git remote add origin https://github.com/user-name/project-name.git
5
git branch -M main
6

7
# 設定作者
8
git config user.name "user-name"
9
git config user.email "user-email"
10
git config credential.useHttpPath true
11

12
# 第一次 Commit / Push
13
git commit -m "Initial commit"
14
git push -u origin main
15

16
# 修正最近一次 Commit 作者資訊
17
git commit --amend --reset-author --no-edit
18

19
# 確認 Author
20
git log -1 --format="%an <%ae>"
21

22
# 更新遠端
23
git push --force-with-lease origin main

Conclusion#

Confirming user.name and user.email before your first push can save you the trouble of modifying Commit History later. If you do push with incorrect information, amend + force-with-lease is the most straightforward way to correct the most recent commit.