通过同一.gitconfig文件无缝连接本地自建Bitbucket与GitHub账户的配置疑问及问题排查

首先得指出一个关键误区：你写的这些Host/HostName配置是SSH客户端的配置，应该放在~/.ssh/config文件里，而不是Git的配置文件.gitconfig中——这是你当前无法正常工作的核心原因之一。

接下来逐个解决配置里的问题：

1. SSH配置（~/.ssh/config）的关键遗漏与修正 #

你的现有配置有几个核心错误，修正后的版本应该是这样：

# Github (默认)
Host gh
HostName github.com
User git
IdentityFile ~/.ssh/id_rsa
IdentitiesOnly yes

# Bitbucket (次要)
Host bb
HostName stash.company.com
User git
IdentityFile ~/.ssh/id_rsa_bb # 建议为Bitbucket单独生成密钥，避免冲突
IdentitiesOnly yes

这里的关键补充和修正点：

• User字段：不管是GitHub还是自建Bitbucket（Stash），SSH连接的用户名都是git——因为平台的SSH服务端都是通过git用户来接收代码仓库的SSH请求的（就像你平时用git@github.com:xxx/xxx.git这样的地址，前面的git就是这个User字段）。
• IdentityFile指向私钥：你之前写的是公钥文件id.pub，这完全错误——SSH连接需要用本地的私钥（比如id_rsa）来做身份验证，公钥是要上传到托管平台的SSH密钥列表里的。另外建议为两个平台分别生成独立的密钥（比如id_rsa给GitHub，id_rsa_bb给Bitbucket），避免密钥冲突导致验证失败。
• 新增IdentitiesOnly yes：这个选项强制SSH只使用你指定的IdentityFile，防止系统自动尝试其他本地密钥，导致平台识别到错误的密钥而拒绝连接。

2. Git用户信息配置（.gitconfig） #

如果你的GitHub个人账户和Bitbucket实例需要使用不同的user.name/user.email（比如工作邮箱用在Bitbucket，个人邮箱用在GitHub），可以在.gitconfig里用条件包含来实现自动切换：

# 默认全局配置
[user]
    name = 你的默认名称
    email = default@email.com

# 当仓库在~/github-repos目录下时，加载GitHub专属配置
[includeIf "gitdir:~/github-repos/"]
    path = ~/.gitconfig-github

# 当仓库在~/bitbucket-repos目录下时，加载Bitbucket专属配置
[includeIf "gitdir:~/bitbucket-repos/"]
    path = ~/.gitconfig-bitbucket

然后分别创建对应的配置文件：

• ~/.gitconfig-github：

  [user]
      name = 你的GitHub用户名/昵称
      email = 你的GitHub绑定邮箱
  

• ~/.gitconfig-bitbucket：

  [user]
      name = 你的Bitbucket显示名称
      email = 你的Bitbucket绑定邮箱
  

这样你在不同目录下克隆/操作仓库时，Git会自动使用对应的用户信息提交代码。

最后验证 #

配置完成后，可以用以下命令测试连接是否正常：

# 测试GitHub连接
ssh -T gh
# 测试Bitbucket连接
ssh -T bb

如果返回类似Hi [你的用户名]! You've successfully authenticated...的提示，就说明配置生效了。

内容的提问来源于stack exchange，提问作者Stat.Enthus