Git需安装并被VS Code识别，SSH密钥绑定GitHub，本地文件夹须初始化为仓库并关联git@github.com远程地址，提交后必须推送才能同步到GitHub。
确认 Git 已安装且能被 VS Code 识别
VS Code 的源代码管理功能不是自带的，它完全依赖本地 git 命令行工具。如果没装 Git 或 PATH 没配对，VS Code 右下角会弹提示“Git not found”，点“源代码管理”图标也只会显示空面板。
- 打开终端（
Ctrl+`），输入git --version；有版本号输出才算通过 - 若报错
command not found，说明 Git 没装，或安装时没勾选“Add Git to the system PATH”（Windows 安装向导第 7 步） - 已安装但 VS Code 找不到？重启 VS Code（不是窗口，是整个进程），或手动在设置里搜
git.path，填入类似C:\Program Files\Git\bin\git.exe的绝对路径
用 SSH 密钥把本地和 GitHub 绑牢
HTTPS 方式每次 push 都要输密码（GitHub 已禁用密码登录），SSH 是唯一稳定、免交互的连接方式。不配 SSH，VS Code 点“推送”会卡在认证环节，甚至静默失败。
- 在项目文件夹里打开 Git Bash，运行
ssh-keygen -t ed25519 -C "your_email@example.com"（别用rsa，GitHub 已不推荐） - 密钥默认存于
~/.ssh/id_ed25519和~/.ssh/id_ed25519.pub；用cat ~/.ssh/id_ed25519.pub复制整段公钥 - 登录 GitHub → Settings → SSH and GPG keys → New SSH key → 粘贴公钥，Title 写个能分辨的名（如 “win-laptop-2026”）
- 测试连通性：
ssh -T git@github.com；成功返回Hi username! You've successfully authenticated...才算完事
把本地文件夹变成 Git 仓库并关联远程地址
VS Code 不会自动初始化 Git 仓库，也不会帮你填远程 URL。你得先让文件夹“自己认得自己是仓库”，再告诉它“该往哪推”。否则右键“提交”能点，但“推送”按钮是灰色的。
- 在 VS Code 中打开你的项目文件夹（不是单个文件！）
- 按
Ctrl+Shift+P打开命令面板，输入并选择Git: Initialize Repository；这会在文件夹里生成.git目录 - 再执行
Git: Add Remote，填远程名（如origin）和 URL（格式必须是git@github.com:username/repo-name.git，不是 HTTPS 链接） - 验证是否绑好：终端里进该文件夹，运行
git remote -v，应看到两行，都含git@github.com
VS Code 里日常提交 + 推送的正确流程
很多人点了“提交”就以为同步完成了，其实只是存到本地仓库；不点“推送”，GitHub 上什么都不会变。而且 VS Code 默认不自动 fetch，别人新提交你也看不到。
- 改完文件后，左侧源代码管理图标旁会出现数字；点开能看到修改列表，勾选要提交的文件，或点顶部“+”暂存全部
- 在输入框写提交信息（不能为空），按
Ctrl+Enter提交（不是回车） - 提交成功后，右上角出现“同步更改”按钮（两个箭头图标）→ 点击它，或按
Ctrl+Shift+P运行Git: Push - 首次推送建议用命令行跑一次
git push -u origin main，这样 VS Code 后续点推送才默认走main分支（GitHub 新仓库默认分支名是main，不是master）
最容易被忽略的是分支名匹配——GitHub 新建仓库默认用 main，但旧项目或本地 init 出来的仓库可能还是 master。VS Code 推送时如果分支不存在于远程，会直接失败，错误信息是 src refspec main does not match any。这时候得先 git branch -M main 改名，再推。
