配置多SSH密钥访问GitHub时Git Config出错问题排查

核心问题 #

你配置了Host别名，但实际Git操作时没有用别名替换原主机名，同时还有一个关键错误：GitHub SSH连接的用户必须是git，不是你的邮箱地址。

正确配置及使用步骤 #

1. 修正SSH配置文件 #

第一种下划线格式的Host别名是正确的（冒号格式会被SSH识别为端口分隔符，属于语法错误），同时把User字段改成git，建议添加IdentitiesOnly yes强制使用指定密钥，避免自动尝试其他密钥导致冲突：

Host github.com_enterprise
    Hostname github.com
    User git
    IdentityFile ~/.ssh/id_enterprise_ssh
    IdentitiesOnly yes

Host github.com_personal
    Hostname github.com
    User git
    IdentityFile ~/.ssh/id_personal_ssh
    IdentitiesOnly yes

2. 使用别名执行Git操作 #

做clone、pull、push等操作时，需要把仓库地址里的github.com替换成你配置的Host别名：

• 企业仓库clone命令：

  git clone git@github.com_enterprise:你的企业组织/仓库名.git
  

• 个人仓库clone命令：

  git clone git@github.com_personal:你的个人用户名/仓库名.git
  

如果是已有的本地仓库，可修改远程地址适配配置：

# 企业仓库修改远程地址
git remote set-url origin git@github.com_enterprise:你的企业组织/仓库名.git

# 个人仓库修改远程地址
git remote set-url origin git@github.com_personal:你的个人用户名/仓库名.git

3. 验证配置有效性 #

用SSH测试连接，确认密钥生效：

# 测试企业密钥
ssh -T github.com_enterprise

# 测试个人密钥
ssh -T github.com_personal

返回类似Hi 你的用户名! You've successfully authenticated, but GitHub does not provide shell access.的信息，说明配置成功。

为什么之前的配置失效？ #

• 你直接使用github.com作为主机名时，SSH只会匹配Host github.com的配置块，不会自动关联带后缀的别名。
• User字段设置为邮箱是错误的，GitHub SSH认证只接受git作为用户名，这会导致认证失败，让你误以为配置没生效。

内容的提问来源于stack exchange，提问作者GianPierre Gálvez