VSCode连接GitHub需分五步：一、手动复制OAuth链接在浏览器授权；二、用Personal Access Token配置Git凭据；三、生成SSH密钥并绑定GitHub实现免密推送；四、初始化本地仓库并关联远程地址使Publish按钮生效；五、启用git.terminalAuthentication触发终端授权窗口。

如果您在 VSCode 中尝试与 GitHub 协同工作，但无法登录账号、推送代码失败或 Publish 按钮无响应，则问题通常源于登录态与 Git 凭据分离、远程仓库未正确关联或认证方式配置不当。以下是解决此问题的步骤：

一、手动完成 GitHub OAuth 授权登录

VSCode 依赖系统默认浏览器唤起 GitHub 的 OAuth 授权页，若跳转失败或空白，说明外部协议处理异常或浏览器未被正确调用。需绕过自动唤起机制，改用人工触发授权流程。

1、点击 VSCode 左下角账户图标，选择“使用 GitHub 登录”。

2、当弹出窗口显示类似 https://github.com/login/oauth/authorize?client_id=... 的链接时，暂停操作，不要关闭窗口。

3、复制该完整 URL，在 Chrome 或 Edge 浏览器中手动粘贴并访问。

4、登录 GitHub 账号后，点击 “Authorize Visual Studio Code” 完成授权。

5、返回 VSCode，账户图标应显示头像及用户名，表示登录成功。

二、配置 Git 凭据以支持 HTTPS 推送

GitHub 账号登录仅用于 VSCode 功能（如 Issues 面板、Copilot），不自动同步至 Git 命令行凭证。HTTPS 方式推送必须使用 Personal Access Token（PAT）替代已停用的密码认证。

1、访问 https://github.com/settings/tokens，点击 “Generate new token” → “Generate new token (classic)”。

2、Token description 填写 “vscode-https-login”，勾选 repo 和 workflow 权限，点击 “Generate token”。

3、复制生成的 token（仅此一次可见），切勿泄露。

4、在 VSCode 终端中执行：git config --global credential.helper store。

5、执行一次推送命令：git push https://github.com/username/repo.git main，当提示输入密码时，粘贴该 PAT。

三、配置 SSH 密钥实现免密推送

SSH 是更安全、稳定的连接方式，避免每次推送输入令牌，且无需依赖系统凭据管理器。需确保本地密钥与 GitHub 账户绑定，并验证连通性。

1、在终端运行：ssh-keygen -t ed25519 -C "your_email@example.com"，按三次回车使用默认路径保存密钥。

2、运行：cat ~/.ssh/id_ed25519.pub，复制整段输出（以 ssh-ed25519 开头）。

One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载

3、登录 GitHub → Settings → SSH and GPG keys → New SSH key，Title 填 “vscode-ssh-win” 或类似标识，粘贴公钥内容。

4、运行：ssh -T git@github.com，若返回 Hi username! You've successfully authenticated...，则配置完成。

5、将远程地址切换为 SSH 格式：git remote set-url origin git@github.com:username/repo.git。

四、初始化本地仓库并关联远程地址

VSCode 不会自动创建 .git 文件夹或添加 remote，必须先完成本地 Git 初始化和远程绑定，Publish 按钮才会激活。否则即使登录成功，推送功能仍不可用。

1、在 VSCode 中打开项目根文件夹（非单个文件），确保所有源码文件在此目录下。

2、按 Ctrl+` 打开集成终端，依次执行：git init、git add .、git commit -m "initial commit"。

3、前往 https://github.com/new 创建空仓库，注意取消勾选 “Initialize this repository with a README”。

4、复制页面显示的远程地址（HTTPS 或 SSH 格式）。

5、在终端执行：git remote add origin https://github.com/username/repo.git（或对应 SSH 地址）。

6、再次查看 VSCode 源代码管理视图，右上角应出现“Publish to GitHub”按钮。

五、启用终端身份验证以触发 GitHub 授权窗口

当 git.push 或 git.pull 报错 “Authentication failed” 且未弹出授权界面时，说明 VSCode 未启用终端级 Git 认证交互。需开启该选项，使每次 Git 操作可唤起 GitHub 授权弹窗。

1、按 Ctrl+Shift+P 打开命令面板，输入并选择 “Preferences: Open Settings (JSON)”。

2、在 settings.json 中添加一行："git.terminalAuthentication": true，保存文件。

3、重启 VSCode，或重新加载窗口（Ctrl+Shift+P → Developer: Reload Window）。

4、在终端执行 git push，应弹出 GitHub 授权窗口，选择账户并允许权限。

5、授权完成后，终端将显示推送成功日志，VSCode 同步更改按钮亦可正常使用。