必须先配置 Git 全局用户名和邮箱,否则提交失败或显示 unknown@unknown;通过 git config --global user.name 和 user.email 设置,邮箱需与平台账号一致,并用 git config --global 验证。

在 Windows 系统中配置 Git 全局用户名和邮箱,是首次使用 Git 前必须完成的一步,否则后续提交(commit)会失败或显示为 unknown@unknown,且该信息一旦写入提交记录就无法修改。
确认 Git 已正确安装并可用
按 Win + R 输入 cmd 或 powershell,回车后输入:
git --version
若返回类似 git version 2.40.1.windows.1 的结果,说明 Git 已就绪;若提示“不是内部或外部命令”,请先重装 Git 并勾选“Add Git to PATH”选项。
用命令行一次性配置全局身份
方法一:在任意目录下打开终端(推荐使用 Git Bash,兼容性更好)→ 执行以下两条命令:
git config --global user.name "张三"
git config --global user.email "zhangsan@example.com"
注意:引号必须是英文半角双引号,姓名和邮箱请替换成你的真实信息。【邮箱必须与 GitHub/GitLab 等平台注册账号一致,否则提交不会关联到你的个人主页】
方法二:如果已安装 VS Code,可直接按 Ctrl + ` 呼出集成终端,粘贴执行上述命令,效果完全相同。
验证配置是否生效
第一步:检查当前生效的用户名和邮箱
git config user.name
git config user.email
第二步:查看全部配置(含全局和本地),确认 user.name 和 user.email 出现在输出中
git config --list
若前两行分别显示你设置的姓名和邮箱,说明配置成功。如果只显示空白或报错 fatal: not in a git directory,请确保没有在某个 Git 仓库子目录里误用了局部配置覆盖——此时可强制读取全局值:
git config --global user.name → 应返回你的姓名;
git config --global user.email → 应返回你的邮箱。


















