git config --global 不能解决分支级身份切换，因为 Git 将 user.name/email 视为仓库级元信息而非分支上下文，全局配置作用于整个用户环境；可行方案是 includeIf 路径匹配加载专属配置，或 git config --local 设置项目级身份。
为什么 git config --global 不能解决分支级身份切换
全局配置只作用于整个用户环境，Git 本身不支持“按分支自动切换 user.name 和 user.email”。当你在公司项目和个人项目间频繁切换分支时，git commit 仍会沿用全局设置，导致提交记录混用邮箱或署名——这不是 Git 的 bug，而是设计使然：它把“身份”视为本地仓库级（甚至更粗粒度）的元信息，而非分支上下文的一部分。
真正可行的路径只有两条：一是为每个项目单独克隆并配置 git config --local；二是用条件式配置（Conditional Includes），让 Git 根据工作目录路径自动加载对应配置。
用 includeIf 实现分支无关但路径敏感的身份隔离
Git 2.13+ 支持 includeIf，它不看分支名，而是根据当前工作目录是否匹配某路径前缀来决定是否加载额外配置。这对“同一仓库多身份”场景最实用——比如你有一个包含多个子模块或需区分用途的 monorepo，但又不想拆成多个独立 clone。
操作步骤：
- 确保 Git 版本 ≥ 2.13：
git --version - 编辑全局配置文件：
git config --global --edit - 在文件末尾添加类似内容：
[includeIf "gitdir:~/work/company/"]
path = ~/work/company/.gitconfig
[includeIf "gitdir:~/dev/my-project/"]
path = ~/dev/my-project/.gitconfig
然后分别创建对应路径下的 .gitconfig 文件，写入专属身份：
# ~/work/company/.gitconfig
[user]
name = Zhang San
email = zhangsan@company.com
[commit]
gpgsign = true
git config --local 在重命名/移动仓库后失效
很多人习惯进到某个分支所在仓库后执行 git config --local user.email "xxx"，以为这样就能绑定该仓库。问题在于：--local 配置写在 .git/config 里，一旦你把整个文件夹重命名、移动位置，或者用 git worktree 新增工作目录，这些配置不会自动迁移或适配新路径。
更麻烦的是：如果该仓库是通过 git clone 得来，而原始远程 URL 已变更（比如从 GitHub 迁移到 GitLab），.git/config 里的 remote 地址可能还指向旧源，但 user.* 配置却没同步更新，造成签名和推送行为不一致。
建议做法：
- 避免手动改
.git/config，优先用includeIf+ 外部配置文件 - 若必须用
--local，每次移动仓库后运行git config --local --edit检查路径有效性 - 配合
git config --list --show-origin快速定位哪条配置来自哪个文件
签名冲突：GPG 密钥与邮箱不匹配时的常见报错
当启用 commit.gpgsign = true 后，Git 会尝试用默认 GPG 密钥签名。但如果该密钥绑定的是 personal@example.com，而当前仓库配置的 user.email 是 work@company.com，GPG 签名虽能成功，但收件方（如 GitHub）可能因邮箱不一致拒绝验证，显示 “Unverified”。
解决方法不是禁用签名，而是显式指定密钥：
# 在分支专属 .gitconfig 中写：
[user]
name = Li Si
email = li.si@company.com
[commit]
gpgsign = true
[user]
signingkey = ABCD1234EFGH5678
其中 ABCD1234EFGH5678 是你用 gpg --list-secret-keys 查到的密钥 ID。注意：这个 ID 必须对应一个已绑定 li.si@company.com 的 GPG 密钥，否则签名无效。
容易忽略的一点是：不同操作系统下 GPG agent 行为差异大。macOS 上可能需要 export GPG_TTY=$(tty) 才能正常调用 pinentry；Windows WSL 则常因 socket 路径问题导致签名卡住——这些都不是 Git 层面的问题，但会直接表现为“签名失败”或“无响应”，得单独排查。
