必须配置，否则 git commit 直接报错：commit is not possible because you have no identity；需用 git config --global 设置 user.name 和 user.email 写入 ~/.gitconfig，全局生效，命令为 git config --global user.name "your name" 和 git config --global user.email "you@example.com"。
必须配置，否则 git commit 直接报错：commit is not possible because you have no identity。这不是可选项，是 Git 提交前的硬性校验。
为什么 git config --global 是最常用起点
全局配置写入 ~/.gitconfig，对所有新克隆或新建的仓库生效，省去每个项目重复设置。新手、个人项目、单邮箱工作流都适合从这里开始。
- 命令只需两行，执行后立即可用：
git config --global user.name "Your Name"和git config --global user.email "you@example.com" - Windows 用户注意：
~指的是C:\Users\用户名\，不是 Git 安装目录或 VS Code 终端当前路径 - 别用中文引号或全角空格——粘贴命令时容易混入，导致配置值带空格或引号，后续
git config user.email返回结果里能看到异常字符
什么时候必须用仓库级配置（git config user.name）
当你同时向 GitHub（用私人邮箱）和公司 GitLab（强制用企业邮箱）提交代码时，全局配置会冲突。这时进到公司项目根目录，去掉 --global 单独配一次：
- 先
cd /path/to/work-repo，确保当前目录下有.git/ - 运行
git config user.name "Zhang San"和git config user.email "zhangsan@company.com" - 该配置只写入
.git/config，不影响其他仓库，也不会覆盖全局值 - 验证是否生效：在该项目内运行
git config user.email，返回的应是公司邮箱；而git config --global user.email仍返回你的私人邮箱
查配置总出错？用 --show-origin 定位真实来源
VS Code 内置终端用 PowerShell、Git Bash 用 mintty、IDEA 又可能调用 cmd —— 不同 shell 读取的配置文件路径可能不一致，导致你以为配好了，实际没生效。
- 统一用
git config --list --show-origin，它会明确告诉你每条配置来自哪个文件（比如file:/home/user/.gitconfig或file:.git/config） - 如果看到某条配置来自
file:C:\Users\XXX\AppData\Roaming\Git\config，那是旧版 Git for Windows 的兼容路径，建议删掉并统一用~/.gitconfig - 别依赖
git config --list，它不显示来源，容易误判哪条配置正在起作用
改完配置不会自动修正历史 commit 的 author 信息，那部分已固化在对象哈希里；真正容易被忽略的是：GitHub/GitLab 只认 commit 中的 user.email 是否与账户绑定邮箱完全一致（包括大小写和前后空格），不一致就显示为 “ghost” 提交——这不是 Git 的问题，是平台校验逻辑。
