Homelab

外观

VSCode 使用不同 GitHub 账户

复制页面

约 1980 字大约 7 分钟

2026-08-26

概述

如果一台电脑上的 VS Code 同时需要操作两个不同的 GitHub 账户，例如：

  • GitHub 账户 A：个人项目
  • GitHub 账户 B：工作项目

不建议频繁切换 VS Code 的 GitHub 登录账号。

更稳定的方式是为两个 GitHub 账户分别创建 SSH Key，通过 ~/.ssh/config 使用不同的 Host 别名区分认证身份，再通过 Git 仓库级配置设置不同的 user.name 和 user.email。

最终实现：

                    ┌── GitHub 账户 A
本机 / VS Code ─────┤
                    └── GitHub 账户 B

SSH Key A ── github-personal ── GitHub A
SSH Key B ── github-work     ── GitHub B

GitHub 官方支持在同一工作站使用多个账户，并建议通过不同协议、凭据或 SSH Key 区分账户。

一、核心原理

需要区分两个概念：

  1. GitHub 认证身份

    决定你有权限向哪个 GitHub 账户的仓库进行 Push，由 SSH Key 决定。例如：

    github-personal → ~/.ssh/id_ed25519_github_personal
github-work     → ~/.ssh/id_ed25519_github_work

  2. Git Commit 身份

    决定这个 Commit 在 GitHub 上显示为谁提交的，由 Git 配置决定：

    git config user.name
git config user.email

重要

GitHub 根据 Commit 中的邮箱地址将提交关联到对应账户，因此两个账户最好分别使用对应账户已验证的邮箱，或 GitHub 提供的 noreply 地址。

完整关系：

SSH Key → GitHub 身份认证 → 是否有权限 Push
user.name + user.email → Commit 作者信息 → GitHub 关联到哪个账户

两者不是一回事。

二、准备两个 GitHub 账户

假设：

用途GitHub 账户邮箱
个人github-personalpersonal@example.com
工作github-workwork@example.com

实际使用时替换成自己的账户和邮箱。

三、分别创建 SSH Key

  1. 创建个人账户 Key

    Windows PowerShell、Git Bash 或 Linux/macOS 终端执行：

    ssh-keygen -t ed25519 -C "personal@example.com" -f ~/.ssh/id_ed25519_github_personal

    生成私钥（不要泄露）与公钥：

    ~/.ssh/id_ed25519_github_personal
~/.ssh/id_ed25519_github_personal.pub

  2. 创建工作账户 Key

    ssh-keygen -t ed25519 -C "work@example.com" -f ~/.ssh/id_ed25519_github_work

    生成：

    ~/.ssh/id_ed25519_github_work
~/.ssh/id_ed25519_github_work.pub

    最终目录：

    ~/.ssh/
├── id_ed25519_github_personal
├── id_ed25519_github_personal.pub
├── id_ed25519_github_work
└── id_ed25519_github_work.pub

四、将 SSH 公钥添加到 GitHub

分别登录两个 GitHub 账户，进入 Settings → SSH and GPG keys → New SSH key，将对应 .pub 公钥内容添加到对应账户：

  • 添加到个人 GitHub 账户

    cat ~/.ssh/id_ed25519_github_personal.pub

  • 添加到工作 GitHub 账户

    cat ~/.ssh/id_ed25519_github_work.pub

GitHub 官方支持使用 SSH Key 进行 Git 操作，并可通过不同 SSH 配置为不同账户使用不同 Key。

五、配置 SSH Host 别名

编辑 ~/.ssh/config（不存在则创建），写入：

# GitHub 个人账户
Host github-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_github_personal
    IdentitiesOnly yes

# GitHub 工作账户
Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_github_work
    IdentitiesOnly yes

提示

  • Host github-personal
  • github-work

上述只是 SSH 别名，最终都连接 github.com，但使用不同 SSH Key。IdentitiesOnly yes 可避免 SSH Agent 加载多个 Key 时选错密钥，GitHub 官方多账户示例也采用这种方式。

六、测试两个 GitHub 账户

测试个人账户：

ssh -T git@github-personal

正常返回：

Hi personal-user! You've successfully authenticated,
but GitHub does not provide shell access.

测试工作账户：

ssh -T git@github-work

如果果两个命令返回的是不同 GitHub 用户名，说明 SSH 多账户配置成功。

七、克隆仓库时使用对应的 Host

这是整个方案最关键的一步，不要使用 git@github.com:...，而是：

个人项目：

git clone git@github-personal:personal-user/project.git

工作项目：

git clone git@github-work:work-user/project.git

这样 Git 会自动选择对应 SSH Key。

八、已 Clone 仓库如何修改 Remote

查看当前 Remote：

git remote -v

修改为个人账户：

git remote set-url origin git@github-personal:personal-user/homelab.git

工作账户：

git remote set-url origin git@github-work:work-user/project.git

再次检查应已变更。

九、设置每个仓库的 Git 提交身份

SSH 解决 Push 使用哪个账户，还需设置 Commit 的作者身份。

进入个人项目：

cd ~/projects/homelab
git config user.name "Personal Name"
git config user.email "personal@example.com"

进入工作项目：

cd ~/projects/work-project
git config user.name "Work Name"
git config user.email "work@example.com"

Git 支持针对单个仓库设置 user.name / user.email，仓库级配置会覆盖全局。

十、检查当前仓库使用哪个身份

git config user.name
git config user.email
git config --local --list
git remote -v

推荐一次性检查：

git config --get user.name
git config --get user.email
git remote -v

个人项目预期：

Personal Name
personal@example.com
origin  git@github-personal:share-nas/homelab.git (fetch)
origin  git@github-personal:share-nas/homelab.git (push)

十一、推荐设置全局默认身份

设置默认身份，新建仓库默认使用个人身份：

git config --global user.name "Personal Name"
git config --global user.email "personal@example.com"

工作项目再单独覆盖：

git config user.name "Work Name"
git config user.email "work@example.com"

这种方式比频繁修改 --global 更安全：Global 为默认，各仓库按需覆盖。

十二、在 VS Code 中正常使用

配置完成后，VS Code 不需要频繁切换 GitHub 账户。直接打开对应项目：

code ~/projects/homelab
code ~/projects/work-project

VS Code 识别项目中的 .git 仓库，使用 Git 的 Remote 与本地配置执行提交、拉取、推送。VS Code 的 GitHub 登录主要用于 GitHub 集成功能；实际 Clone/Pull/Push 直接使用本机 Git 配置的 SSH 凭据。

十三、一个完整示例

假设个人账户 share-nas（邮箱 personal@example.com）、工作账户 company-user（邮箱 work@example.com）。

个人项目：

cd ~/projects/homelab
git remote set-url origin git@github-personal:share-nas/homelab.git
git config user.name "share-nas"
git config user.email "personal@example.com"

工作项目：

cd ~/projects/project
git remote set-url origin git@github-work:company-user/project.git
git config user.name "company-user"
git config user.email "work@example.com"

十四、提交前快速检查

提交前确认身份与 Remote：

echo "=== Git Identity ==="
git config user.name
git config user.email
echo "=== Git Remote ==="
git remote -v

确认无误后再：

git add .
git commit -m "update"
git push

十五、查看 Commit 使用的身份

查看最近一次提交：

git log -1 --format=fuller

或：

git log -1 --format='%an <%ae>'

可在 Push 前确认作者是否正确。

十六、常见问题

  1. 两个账户都配了 SSH Key 但仍登录错账户

    测试两个 Host：

    ssh -T git@github-personal
ssh -T git@github-work

    若返回相同账户，检查 ~/.ssh/config 中 IdentitiesOnly yes 是否存在。

  2. Permission denied (publickey)

    ls ~/.ssh/
ssh -vT git@github-personal
ssh -vT git@github-work

    重点观察 SSH 最终尝试的是哪个 Key。

  3. Commit 显示成了错误的 GitHub 账户

    git config user.email

    若错误则修正：

    git config user.email "correct@example.com"

    笔记

    修改 Git 配置只影响后续 Commit，不会自动修改已创建的 Commit。

  4. Push 权限正确但贡献记录不显示

    检查 git config user.email 是否与对应 GitHub 账户关联，可优先使用 GitHub 提供的 noreply 邮箱减少真实邮箱暴露。

  5. VS Code 左下角登录的是另一个 GitHub 账户

    这通常不等于 Git Push 使用的 SSH 账户。需区分：

    • VS Code GitHub 登录 → GitHub 扩展、PR、Issue 等功能
    • SSH Key → Git Clone/Pull/Push
    • git user.email → Commit 作者归属

    不要仅因 VS Code 显示另一个用户就认为 Push 会使用错误账户。

十七、最终推荐目录结构

~/.ssh/
├── config
├── id_ed25519_github_personal
├── id_ed25519_github_personal.pub
├── id_ed25519_github_work
└── id_ed25519_github_work.pub

config：

Host github-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_github_personal
    IdentitiesOnly yes

Host github-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_github_work
    IdentitiesOnly yes

仓库：

~/projects/
├── homelab/
│   └── .git/ → Remote: github-personal
└── work-project/
    └── .git/ → Remote: github-work

十八、最终效果

配置完成后无需退出/登录 GitHub、修改 VS Code 账户、重新认证。每个仓库只需配置一次，之后无论 VS Code 图形界面还是终端，都会自动使用该仓库对应的 GitHub 账户。

总结

同一台电脑管理多个 GitHub 账户，推荐遵循三个原则：

项目负责什么配置位置
SSH KeyGitHub 登录 / Push 权限~/.ssh/
SSH Host选择哪个 SSH Key~/.ssh/config
user.name / user.emailCommit 作者Git 仓库 .git/config

最关键的配置就是：

github-personal → SSH Key A → GitHub A
github-work     → SSH Key B → GitHub B

以及：

个人仓库 → git@github-personal:...
工作仓库 → git@github-work:...

这样可以让 VS Code、Git 命令行和 GitHub 多账户管理保持一致，也是长期使用最不容易误提交到错误账户的方案。

重要

SSH Key 是认证身份，user.email 是 Commit 身份。两者都需正确配置，不能只配置其中一个。

许可证：署名 4.0 国际 (CC-BY-4.0)