Git 多 GitHub 账号管理方案
场景
多个 GitHub 账号需要在不同项目中自动切换身份和凭据，无需手动操作。
当前配置
| 目录 | GitHub 账号 | SSH Host 别名 |
|---|---|---|
~/Projects/work/ |
work-account | github-work |
~/Projects/opensource/ |
personal-account | github-personal |
~/Projects/personal/ |
personal-account | github-personal |
方案：SSH Key 别名 + includeIf + insteadOf
一次配置，零维护。现有 HTTPS clone 的项目无需修改 remote URL。
1. SSH Key
ssh-keygen -t ed25519 -C "work-account" -f ~/.ssh/id_work
ssh-keygen -t ed25519 -C "personal-account" -f ~/.ssh/id_personal
通过 gh 添加到对应账号：
# 公司账号（gh 当前登录）
gh ssh-key add ~/.ssh/id_work.pub --title "WSL-work-ed25519"
# 个人账号（先切换）
gh auth login -h github.com
gh ssh-key add ~/.ssh/id_personal.pub --title "WSL-personal-ed25519"
gh auth switch -u work-account # 切回公司账号
gh 需要 admin:public_key scope，首次可能需要 gh auth refresh -h github.com -s admin:public_key。2. SSH Config
~/.ssh/config（仅 GitHub 相关部分）：
Host github-work
HostName github.com
User git
IdentityFile ~/.ssh/id_work
IdentitiesOnly yes
Host github-personal
HostName github.com
User git
IdentityFile ~/.ssh/id_personal
IdentitiesOnly yes
IdentitiesOnly yes 防止 SSH agent 发送错误的 key。
3. Git includeIf
~/.gitconfig：
[user]
name = your-name
email = your-email@example.com
[includeIf "gitdir:~/Projects/work/"]
path = ~/.gitconfig-work
[includeIf "gitdir:~/Projects/opensource/"]
path = ~/.gitconfig-personal
[includeIf "gitdir:~/Projects/personal/"]
path = ~/.gitconfig-personal
gitdir: 路径末尾的 / 表示递归匹配子目录，不要漏掉。4. 子配置文件（url.insteadOf）
~/.gitconfig-work：
[url "git@github-work:"]
insteadOf = git@github.com:
insteadOf = https://github.com/
~/.gitconfig-personal：
[url "git@github-personal:"]
insteadOf = git@github.com:
insteadOf = https://github.com/
insteadOf 同时匹配 SSH 和 HTTPS URL，已有项目的 .git/config 中 remote 不需要改动。
[1]
5. 验证
# SSH 连接
ssh -T git@github-work # → Hi work-account!
ssh -T git@github-personal # → Hi personal-account!
# Git 身份（进入对应目录）
git config user.email
# 实际 fetch
cd ~/Projects/work/some-repo && git fetch
cd ~/Projects/opensource/some-repo && git fetch
6. 防火墙封 SSH 22 端口
改用 443 端口：
Host github-work
HostName ssh.github.com
Port 443
User git
IdentityFile ~/.ssh/id_work
IdentitiesOnly yes
方案对比
| 方式 | 多账号支持 | 维护成本 | 备注 |
|---|---|---|---|
| SSH key 别名 | ✅ 原生 | 低 | 推荐，一次配置零维护 |
| HTTPS + GCM | ✅ | 中 | Linux 上需额外配置 |
| HTTPS + PAT | 需 useHttpPath | 高 | token 过期需手动刷新 |
| gh CLI | 单账号为主 | 高 | 多账号支持差 |
新增账号
- 生成新 key：
ssh-keygen -t ed25519 -f ~/.ssh/id_xxx ~/.ssh/config添加 Host 别名~/.gitconfig添加includeIf条目- 创建对应
.gitconfig-xxx，写url.insteadOf gh ssh-key add或手动添加 public key 到 GitHub