问题：如何修改Git提交时显示的用户名？

Question

问题：如何修改 Git 提交时显示的用户名？ 在使用 Git 进行版本控制时，用户提交代码时会记录用户名和邮箱。若希望修改提交信息中显示的用户名，可通过 `git config` 命令进行设置。可分别设置全局用户名或针对单个项目进行局部配置。此外，有时开发者会遇到配置未生效的问题，通常是因为未正确使用 `--global` 参数或配置文件冲突。了解如何查看当前配置、修改用户名及作用范围，是解决此问题的关键。本文将详细介绍修改 Git 提交用户名的方法，并解答常见疑问。

Answer 1

一、Git 提交用户名的基本概念

在 Git 中，每次提交（commit）都会记录提交者的用户名和邮箱信息。这些信息用于标识是谁进行了代码的修改。

Git 支持两种配置级别：

• 全局配置：适用于本机所有 Git 项目。
• 局部配置：仅适用于当前项目的 Git 提交信息。

二、查看当前 Git 用户名配置

在修改之前，建议先查看当前的用户名配置情况：

git config user.name

若想查看全局设置：

git config --global user.name

查看所有配置项：

git config --list

三、修改 Git 提交时显示的用户名

可根据需要选择以下两种方式进行设置：

设置范围	命令示例	适用场景
全局设置	git config --global user.name "New Name"	适用于本机所有项目
局部设置	git config user.name "New Name"	仅适用于当前 Git 仓库

四、常见问题与排查方法

有时候用户设置了新的用户名后发现未生效，可能是以下原因：

1. 未使用 --global 参数导致只修改了当前仓库。
2. 多个配置文件冲突，如 .git/config 和 ~/.gitconfig。
3. IDE 或图形界面工具缓存了旧配置。
4. 使用了错误的 Git 配置作用域。

五、高级操作：强制修改历史提交的用户名

如果已经提交过 commit 并希望修改历史中的用户名，可以使用如下脚本：

git filter-branch --env-filter '
    OLD_EMAIL="[e-mail]"
    CORRECT_NAME="New Name"
    CORRECT_EMAIL="[e-mail]"
    if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]; then
        export GIT_COMMITTER_NAME="$CORRECT_NAME"
        export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL"
    fi
    if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]; then
        export GIT_AUTHOR_NAME="$CORRECT_NAME"
        export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL"
    fi
    ' HEAD

该脚本将替换指定邮箱对应的所有提交者信息。

六、流程图：Git 用户名配置决策路径

            
                graph TD
                    A[是否只想修改当前项目？] -->|是| B[进入局部配置]
                    A -->|否| C[进入全局配置]
                    B --> D[执行 git config user.name]
                    C --> E[执行 git config --global user.name]
                    D --> F[验证配置是否生效]
                    E --> F
                    F --> G{是否仍无效？}
                    G -->|是| H[检查配置文件冲突]
                    G -->|否| I[完成设置]
                    H --> J[手动编辑 .git/config 或 ~/.gitconfig]