在 macos 上实现 git 多账户身份切换需分离提交身份（user.name/email）与认证身份（ssh/https），通过 includeif 自动匹配仓库域名加载对应 ~/.gitconfig-*，并用 ~/.ssh/config 按 host 别名分发不同密钥。
在 macos 上实现分布式开发所需的 git 多账户身份切换，关键在于把提交身份（user.name / user.email）和认证身份（ssh 密钥或 https 凭据）分开管理，并让它们按仓库自动匹配。不是靠手动切换，而是靠配置驱动的自动识别。
区分两种身份：提交者 vs 认证者
很多人混淆了这两层：
-
提交身份：决定 git log 里显示谁改了代码，由
user.name和user.email控制，纯本地配置 - 认证身份：决定你有没有权限 push/pull，由 SSH 私钥或 HTTPS 用户名密码控制，走系统级通信协议
分布式开发中，你可能向公司 GitLab、GitHub 开源项目、Gitee 镜像库同时推送——每个平台需要不同邮箱签名 + 不同密钥认证。必须两者协同，缺一不可。
用 includeIf 实现提交身份自动切换（Git 2.36+）
这是最干净、最可维护的方式，无需进每个项目手动设 git config --local。
- 创建专用配置文件：
touch ~/.gitconfig-work，写入：[user]<br> name = 李四（XX科技）<br> email = lisi@xxtech.com
- 同样建
~/.gitconfig-github：[user]<br> name = lisi<br> email = lisi@users.noreply.github.com
（用 GitHub 的 noreply 邮箱保护隐私） - 编辑
~/.gitconfig，加入条件加载规则：[includeIf "hasconfig:remote.*.url:https://gitlab.xxtech.com/**"]<br> path = ~/.gitconfig-work<br>[includeIf "hasconfig:remote.*.url:https://github.com/**"]<br> path = ~/.gitconfig-github
只要远程地址匹配对应域名，Git 就自动套用该配置。支持 HTTPS 和 SSH 协议，且对子模块、克隆后新建分支等场景都生效。
用 ~/.ssh/config 管理认证身份自动路由
SSH 密钥不能共用，但可以按 Host 别名智能分发。
- 为每个账号生成独立密钥：
ssh-keygen -t ed25519 -C "lisi@xxtech.com" -f ~/.ssh/id_ed25519-xxtechssh-keygen -t ed25519 -C "lisi@gmail.com" -f ~/.ssh/id_ed25519-github - 编辑
~/.ssh/config：# 公司 GitLab<br>Host gitlab.xxtech.com<br> HostName gitlab.xxtech.com<br> User git<br> IdentityFile ~/.ssh/id_ed25519-xxtech<br> IdentitiesOnly yes<br><br># GitHub 个人<br>Host github.com<br> HostName github.com<br> User git<br> IdentityFile ~/.ssh/id_ed25519-github<br> IdentitiesOnly yes
- 确保仓库 remote URL 是标准格式（如
git@gitlab.xxtech.com:team/repo.git），SSH 客户端会自动根据 Host 名匹配密钥
SourceTree 或其他 GUI 工具兼容处理
GUI 工具通常不读取 includeIf，但能识别本地配置和 SSH 设置：
- 首次克隆时，用正确的 SSH URL（如
git@gitlab.xxtech.com:user/repo.git），SourceTree 会自动调用 ~/.ssh/config 中对应的密钥 - 进入项目后，在 SourceTree → Repository Settings → Advanced → Edit Config File，手动添加本地用户配置：
[user]<br> name = 李四（XX科技）<br> email = lisi@xxtech.com
- 或者更省事：在终端进项目目录执行一次
git config user.email "lisi@xxtech.com"，SourceTree 会同步读取
这样既保住了命令行的自动化，又让 GUI 正常工作，不冲突。
