VSCode通过Git集成与GitHub交互，需手动初始化本地仓库、配置远程地址并解决认证问题；HTTPS推送须用PAT令牌，SSH需配置密钥；首次推送推荐git push -u origin main。
VSCode 本身不“连接” GitHub，它通过 Git 集成与本地仓库协作，再由 Git 命令（如 git push、git pull）与 GitHub 远程仓库通信。所谓“连接 GitHub”，本质是配置好本地 Git 仓库的远程地址，并确保认证可用。
确认 VSCode 已启用 Git 支持并识别到本地仓库
VSCode 的源代码管理（SCM）视图依赖 Git CLI 和工作区根目录下的 .git 文件夹。如果看不到分支、提交按钮或文件变更列表：
- 检查是否在项目根目录打开文件夹（而非单个文件）——VSCode 只对含
.git的文件夹激活 Git 视图 - 运行
git --version确认系统已安装 Git；若未安装，VSCode 会提示，但不会自动补全 - 在 VSCode 设置中搜索
git.enabled，确保值为true - 终端中执行
git status能正常返回，说明 Git 可用；否则 SCM 视图将灰显
把本地文件夹初始化为 Git 仓库并关联 GitHub 远程
这是从零开始最常卡住的一步：VSCode 不替你执行 git init 或 git remote add，它只提供 UI 封装已有 Git 操作。
- 先在项目根目录打开终端（VSCode 内置终端快捷键
Ctrl+`），运行：git init
git add .
git commit -m "initial commit" - 去 GitHub 创建新仓库（注意：不要勾选 “Initialize this repository with a README”——否则会冲突）
- 复制 GitHub 页面上显示的远程地址（
https://github.com/username/repo.git或git@github.com:username/repo.git） - 在终端执行：
git remote add origin https://github.com/username/repo.git - 之后 VSCode 的 SCM 视图右上角会出现 “Publish to GitHub” 按钮（仅当有本地提交且存在 remote origin 时）
解决 “Authentication failed” 或 “Permission denied (publickey)”
推送失败几乎都源于认证问题，和 VSCode 关系不大，但错误提示容易让人误以为是编辑器设置问题。
- 用 HTTPS 地址（
https://...）时：VSCode 会调用系统凭据管理器（Windows Credential Manager / macOS Keychain），首次推送会弹窗要求输入 GitHub 账号密码——但 GitHub 已禁用密码登录，必须用 Personal Access Token（PAT） 替代密码 - 用 SSH 地址（
git@...）时：需提前生成 SSH key（ssh-keygen -t ed25519 -C "your_email@example.com"），并把公钥（~/.ssh/id_ed25519.pub）完整粘贴进 GitHub Settings → SSH and GPG keys - 验证 SSH 是否生效：终端运行
ssh -T git@github.com，返回 “Hi username! You've successfully authenticated…” 即可 - VSCode 中切换远程地址类型：命令面板（
Ctrl+Shift+P）→ 输入 “Git: Configure Remotes” → 编辑 origin URL
日常操作别绕过终端，尤其首次推送和分支管理
VSCode 的图形化操作（如点击 “+” 提交、“↑” 推送）对简单场景够用，但分支创建、rebase、解决冲突等仍需终端配合，且部分操作不可逆。
- 首次推送建议用命令：
git push -u origin main（-u设定上游跟踪，之后直接git push即可） - VSCode 创建新分支后，默认不会自动切换 —— 点击左下角分支名才能 checkout，否则提交仍进当前分支
- 拉取远程更新推荐用
git pull --rebase（避免无意义 merge 提交），VSCode 默认执行的是git pull（含 merge） - 遇到冲突时，VSCode 会高亮标记，但最终要手动编辑文件、删掉 git add +
git rebase --continue，不能只点 UI 上的 “Accept Current Change”
真正的难点不在 VSCode 界面操作，而在于理解 Git 的本地快照模型、远程追踪机制和认证链路。很多人反复重装插件或重配设置，其实只是没跑通那几条基础 git 命令。先让终端里的 git push 成功一次，VSCode 的 UI 才真正“活”起来。
