版本控制与协作 / 系统课时

配置用户名与邮箱

配置用户名与邮箱

学习目标

完成本课后,你将能够:

  • 配置 Git 提交用户名和邮箱
  • 区分全局身份与仓库级身份
  • 从提交记录验证作者信息

核心原理

user.name 和 user.email 是写入提交对象的文本字段,不会自动验证邮箱是否真实,也不等同于远程平台登录凭据。全局配置为当前操作系统用户提供默认值,仓库级配置只影响当前仓库,并具有更高优先级。

提交中还区分 Author 与 Committer。普通提交二者通常相同;应用补丁、变基或代替他人提交时可能不同。修改配置只影响之后创建的提交,不会自动改写既有历史。

基础用法

设置个人默认身份可使用 git config --global user.name 和 git config --global user.email。公司仓库需要单独身份时,在仓库目录内省略 --global 设置本地配置。使用 git config --get-regexp "^user\." 检查当前生效值,提交后再通过 git log -1 --format 验证。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。

bash
rm -rf git-identity-demo
mkdir git-identity-demo
cd git-identity-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "identity demo\n" > README.md
git add README.md
git commit -q -m "docs: add identity demo"
git config --get-regexp '^user\.'
git log -1 --format='author=%an <%ae>%ncommitter=%cn <%ce>'

预期输出

text
user.name Anystack Student
user.email student@example.com
author=Anystack Student <student@example.com>
committer=Anystack Student <student@example.com>

Tips

  • 在提交前运行 git config user.email,确认公司仓库没有误用私人邮箱。
  • 需要隐藏公开邮箱时,可使用托管平台提供的匿名邮箱,但仍应遵循团队规范。
  • 身份配置错误且尚未推送时,可修正配置后使用 amend 更新最近提交。

常见错误

1. 把密码写入 user.email

  • 错误表现:误以为该字段用于远程登录。
  • 正确处理:user.email 只表示提交作者邮箱,认证应使用 SSH 密钥、令牌或平台凭据管理。

2. 修改配置后历史仍未变化

  • 错误表现:期待旧提交自动显示新邮箱。
  • 正确处理:配置只影响新提交;改写历史需要额外操作,并可能影响已共享仓库。

本课练习

1. 设置全局身份

  • 任务目标:设置全局身份。
  • 输入或初始条件:使用自己的教学名称和邮箱。
  • 实现要求:设置后分别读取两个值。
  • 验收条件:输出与输入完全一致。

2. 覆盖仓库身份

  • 任务目标:覆盖仓库身份。
  • 输入或初始条件:创建测试仓库。
  • 实现要求:设置仓库级邮箱并比较全局值和当前生效值。
  • 验收条件:仓库内读取到本地邮箱,仓库外仍是全局邮箱。

3. 验证提交作者

  • 任务目标:验证提交作者。
  • 输入或初始条件:在测试仓库创建一次提交。
  • 实现要求:用格式化日志只输出作者名称和邮箱。
  • 验收条件:日志与当前仓库配置一致。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置用户名与邮箱

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通