# 关于name与email

我们一般在主机上装好git后，都需要通过以下的两条命令设置user.name与user.email信息

```
$ git config --global user.name xxxx
$ git config --global user.email xxxx@example.com
```

当我们有多台主机向git服务器提交代码时， 此时git服务器就需要知道每一次提交是谁的。此时，就是通过user.name来进行区分。

比如，我们从两台不同的主机上向gogs中的learngit项目进行两次提交，在该项目中就可以看到两次提交的user.name是不一样的（注意，尽管两次提交用的都是gogs中的pshizh同一个用户）

![](/files/-M69E3k1hH-jR-wG5TJ2)

上图中的`docker162`就是162主机上的user.name，`docker163`就是163主机上的user.name

但是但是，在github上，commit history中显示的不是主机上设置的user.name，而是github的账号（当我们git push到github时，是携带了github账号的信息的）：

![](/files/-M69E3k2Ey0_4LkgRP7W)

## 设置用户名与邮箱

```
$ git config --[local|global|system] user.name xxx
$ git config --[local|global|system] user.email xxx@example.com
```

在设置用户名与邮箱的时候，可以设置不同的范围：

* local：当前仓库，在当前仓库的`.git/config`文件中
* global：当前用户，在当前用户的`~/.gitconfig`文件中
* system：系统范围，在`/etc/gitconfig`文件中

**最佳实践：有可能同一台主机需要连接多个远程仓库，而且每个远程仓库的用户名可能不一样，所以最好使用`--local`选项给每个项目单独设置，设置为远程仓库的登录用户名。**

## 查看用户名与邮箱

```
$ git config user.name
$ git config user.email
```

上面的命令查找的范围依次是local、global、system。

## Reference

\[1] <https://blog.csdn.net/hutaoer06051/article/details/8275069>

\[2] <https://www.jianshu.com/p/d24e791a7679>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pshizhsysu.gitbook.io/git/guan-yu-config/guan-yu-name-yu-email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.