VSCode依赖系统已安装的Git，需确保git在PATH中且终端可用；初始化仓库、暂存、提交、推送等操作均与命令行一致，但不支持一键创建远程库或hard reset。
VSCode 本身不自带 Git，但能无缝调用系统已安装的 Git 命令行工具——只要你的 git 在终端可用，VSCode 的源代码管理（SCM）面板就能直接工作。
确认 Git 已正确安装并被 VSCode 识别
打开 VSCode 终端（Ctrl+`），输入：git --version。如果返回类似 git version 2.40.1，说明 Git 可用；若提示 command not found，需先安装 Git 并确保它加入系统 PATH。
VSCode 默认会从系统 PATH 查找 git，不支持通过 GUI 安装路径硬编码指定。常见坑：
- Windows 上用 Git for Windows 安装时，勾选 “Add Git to PATH”（推荐选 “Git from the command line and also from 3rd-party software”）
-
macOS 用 Homebrew 安装后，若用 zsh，检查
~/.zshrc是否有export PATH="/opt/homebrew/bin:$PATH" - VSCode 启动方式影响 PATH：从桌面图标启动可能不加载 shell 配置，建议从终端执行
code .打开项目
初始化仓库、添加文件并提交
在 VSCode 中打开一个空文件夹（非已有 Git 仓库），点击左侧活动栏的源代码管理图标（分支图标），底部状态栏会出现 “Initialize Repository”。点击即执行 git init。
此时未跟踪的文件会列在 “CHANGES” 下方的 “UNTRACKED” 区域。操作逻辑和命令行一致：
- 点击文件名左侧的
+号，等效于git add - 右键文件 → “Stage Changes”，或全选后点顶部 “+” 按钮，等效于
git add . - 在上方输入框写提交信息（必须非空），按
Ctrl+Enter提交，等效于git commit -m "xxx"
注意：VSCode 不默认启用 git commit --no-verify，如果项目配置了 pre-commit 钩子，失败时提交会被中断，且错误信息直接显示在弹窗中——这不是 VSCode 问题，是钩子本身拒绝。
推送（push）前必须关联远程仓库
提交只是本地操作。要推送到 GitHub/GitLab 等平台，得先有远程地址。VSCode 不提供“一键创建远程仓库”功能（不调用 GitHub API），你得手动创建空仓库，再复制其 HTTPS 或 SSH 地址。
在 VSCode 终端中运行：git remote add origin https://github.com/username/repo.git
之后才能使用 UI 推送：
- 点击 SCM 面板右上角 “...” → “Push”（首次推送会提示选择分支和远程）
- 或点击状态栏分支名（如
main），选择 “Push to origin/main”
常见失败原因：
-
fatal: The current branch main has no upstream branch：没运行过git push -u origin main，VSCode 的首次推送会自动加-u，但如果你跳过这步直接点 Push，可能报错 - HTTPS 方式推送时提示用户名密码：GitHub 已停用账户密码登录，需用 Personal Access Token（PAT）代替密码，或改用 SSH
- SSH key 未添加到 ssh-agent 或 GitHub 账户：运行
ssh -T git@github.com测试连通性
处理常见冲突与撤销误操作
VSCode 对合并冲突有可视化支持，但不会自动解决。当 git pull 或 git merge 出现冲突时，文件会在 SCM 面板中标为 “MERGING”，打开文件能看到 和 >>>>>> branch-name 的冲突标记。
你可以：
- 鼠标悬停在冲突块上，出现 “Accept Current Change” / “Accept Incoming Change” / “Accept Both Changes” 快捷按钮
- 手动编辑删掉标记行，保留想要的内容，保存后点击 “+” 添加，再正常提交
误提交但还没推送？在 SCM 面板点击 “...” → “Undo Last Commit”，等效于 git reset --mixed HEAD~1（保留修改，取消暂存和提交）；如果想连修改也丢弃，得在终端手动 git reset --hard HEAD~1 —— VSCode UI 不提供 hard reset 选项，这是有意为之的安全限制。
真正容易被忽略的是：VSCode 的“暂存”（Stage）和“提交”（Commit）是两个独立动作，很多人点了 “+” 却忘了写提交信息按 Ctrl+Enter，结果文件一直卡在 “STAGED CHANGES” 里，以为已经提交成功。
