VS Code 初次使用 Git 出现：“Make sure you configure your “user.name” and “user.email” in git.”

1. 突然出现的拦截

很多刚开始接触编程或者刚换了新电脑的朋友，在 VS Code 里愉快地敲完代码，准备按下“提交（Commit）”按钮记录自己的伟大成果时，往往会猝不及防地遇到一个报错提示框，或者在输出面板看到类似下面这样的一段红字：

Make sure you configure your "user.name" and "user.email" in git.

Git 报错截图 不用慌，这不是你的代码写错了，而是 Git 跟你“互不相识”。

2. 为什么会出现这个问题？

git的核心机制就是知道你是谁、你在干嘛（版本控制器），所以当git不知道你的信息，他就没办法工作。 这时候就需要把你的信息输入给git.

3. 三步解决：告诉 Git 你是谁

解决这个问题非常简单，只需要两行命令。由于我们是在 VS Code 里写代码，整个过程完全不需要切出编辑器。

步骤一：唤出 VS Code 终端 在 VS Code 中，你可以通过快捷键 Ctrl` + \` （数字 1 左边的那个按键）快速打开底部集成终端；或者在顶部菜单栏选择“终端 (Terminal)” -> “新建终端 (New Terminal)”。

步骤二：输入配置命令 在终端的命令行窗口中，依次输入以下两行命令并回车：

git config --global user.name "你的名字或昵称"
git config --global user.email "你的邮箱@example.com"

💡 提示：这里的 --global 参数表示“全局配置”。也就是说，你只要在你的电脑上配置这一次，以后不管你在哪个文件夹建什么新项目，Git 都会默认使用这个身份。 如果没有global呢？ 如果没有global就代表这个git的改变只能在当前仓库使用，如果下一次在其他仓库提交还是需要再次设置。所以一般为了方便使用，大多都直接用global。

4. ⚠️ 核心避坑：昵称和邮箱能随便填吗？（重点！）

很多新手在输入上面的命令时会犹豫：“这个名字和邮箱需要和我以后注册的 GitHub/Gitee 账号一样吗？能随便瞎填吗？”

这里必须分情况讨论，特别是邮箱的填写，直接关系到你以后的代码贡献记录，千万不要随便填！

🔴 强烈建议：邮箱填真实注册邮箱，名字填常用昵称

如果你打算以后把代码推送到 GitHub、Gitee (码云) 或公司的 GitLab 等线上托管平台，请务必遵守以下规则：

  • 邮箱 (Email) —— 必须与平台注册邮箱一致：线上代码托管平台是唯一通过邮箱来识别提交者身份的！如果你的 Git 本地邮箱和你注册平台的邮箱完全一致，代码推送到线上后，提交记录旁边才会显示你的头像，并且点亮你主页上诱人的**“代码贡献度小绿点”。如果这里随便填，代码虽然能传上去，但平台根本不认识你，只会显示一个灰色的默认头像，且不计入你的任何贡献**。
  • 名字 (Name) —— 方便辨认即可：名字的作用主要是在团队协作时，让看代码历史的人能一眼认出是你。

⚪ 本地自娱自乐：可以随便填

如果你非常确定，你的代码永远只存在你自己的电脑硬盘里，绝对不会上传到任何网络平台。那么在本地，name和email就随便了。 (不过为了养成良好的开发者习惯，还是建议一开始就配置好真实的邮箱。)

5. 验证一下：问题解决了吗？

怎么确认我们刚才的命令有没有生效呢？终端里输入：

git config --list

如果在输出的列表中能看到你刚刚设置的 user.name 和 user.email，那就说明配置成功了！

现在，回到 VS Code 左侧的“源代码管理”界面，再次在输入框里写下你的 Commit 信息，点击“提交”按钮。你会发现，烦人的报错不见了，代码成功提交入库。

6. 进阶小贴士

  • 我不小心打错字了怎么办？ 别紧张，Git 配置遵循“覆盖原则”。如果你发现名字或邮箱拼错了，只需要把上面那两条配置命令带着正确的信息重新运行一遍，新的配置就会自动覆盖旧的。
  • 工作与个人项目怎么区分？ 如果你在工作电脑上开发，全局（global）一般会配置成公司邮箱。但如果偶尔想在这台电脑上维护自己的个人项目，你只需要在 VS Code 中打开个人项目文件夹，然后在终端输入去掉了 --global 的命令： 
    git config user.name "私人昵称"
git config user.email "个人邮箱@qq.com"
    这样，Git 会优先使用这个项目局部的配置，完美隔离个人与工作身份。

7. 总结

遇到“Make sure you configure your “user.name” and “user.email” in git.”可以说是每个 Git 新手必经的“成人礼”。通过这次报错，我们不仅学会了基础配置，更重要的是避开了“乱填邮箱导致丢失代码贡献记录”的大坑。

希望这篇小记录能帮你扫清初学路上的一个小障碍，祝你以后的每一次 Commit 都能顺顺利利，早日种满主页的小绿点！