git 错误：键 user.name 有多个值：- Shell-Bash

当你遇到类似以下错误信息时：

git 错误：键 user.name 有多个值：- Shell-Bash

说明你在 Git 中有重复的配置项，此时系统无法知道该使用哪个配置项，会导致 Git 出现错误。

通常，这种情况都是因为用户在多个配置文件或在同一配置文件中多次设置了同一配置项所导致。

要解决这个问题，你需要执行以下步骤：

1. 确认在哪些文件中设置了 user.name 这个配置项

你可以使用 git config --list --show-origin 命令检查该配置项在哪些文件中被设置了。

$ git config --list --show-origin | grep user.name
file:/path/to/first/git/config	user.name=UserName
file:/path/to/second/git/config	user.name=UserName

从输出中可以看到，在两个不同的配置文件中都设置了 user.name 这个配置项。

2. 删除冗余的配置项

在上一步中，你已经知道哪些配置文件里存在重复的配置项了。

下面以 ~/.gitconfig 文件为例，假设此文件同时存在以下两条配置项：

[user]
	name = UserName1

[user]
	name = UserName2

显然，这里就出现了重复配置的情况。

你需要将其中一条重复的配置项删除，以解决该问题。

可以手动打开配置文件删除，也可以通过以下命令删除冗余配置项：

$ git config --unset-all user.name

如果你执行该命令后返回了空白或者没有任何输出，那么说明该配置项已经被删除了。

3. 重新设置配置项

现在，你需要重新设置你的 Git 用户名。可以通过以下命令来设置：

$ git config --global user.name "UserName"

其中，"UserName" 是你想要设置的用户名。

注意：如果你在多个配置文件中都对 user.name 进行了设置，那么你需要对每一个文件中的该项进行删除和重新设置。

总结

在 Git 中出现“键 user.name 有多个值”这个错误时，一般是由于用户定义了多次同名的配置项所导致。

你可以通过检查哪些文件中设置了该配置项，删除冗余的配置项，重新设置配置项等方式来解决该问题。