VS Code 依赖外部 Git 工具实现版本控制，需确保系统已安装并正确配置 git 路径；通过 SCM 视图、命令面板和合理设置可高效完成暂存、提交、分支切换等操作。
VS Code 本身不内置 Git，但通过深度集成 git 命令行工具和内置的源代码管理（SCM）视图，能实现比 GUI 客户端更轻量、更可控的版本控制流程——前提是你的系统已安装并配置好 git，且 VS Code 能正确识别它。
确认 VS Code 已正确识别系统 git
这是绝大多数“Git 不工作”问题的根源。VS Code 不自带 Git，它依赖外部 git 可执行文件。
- 打开 VS Code，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Git: Show Git Output并回车，查看输出面板中是否显示类似Using git 2.40.1 from /usr/bin/git的路径信息 - 若提示
Git not found或路径为空，说明 VS Code 找不到git：检查终端中运行git --version是否正常；macOS 用户常见问题是git在 Terminal 中可用，但在 VS Code GUI 启动时 PATH 未继承，需在~/.zshrc（或对应 shell 配置）中确保export PATH="/opt/homebrew/bin:$PATH"类路径生效，并重启 VS Code - 也可手动指定路径：设置中搜索
git.path，填入绝对路径，如/usr/local/bin/git或C:\Program Files\Git\bin\git.exe
用 SCM 视图完成日常提交、暂存与撤销
左侧活动栏的源代码管理图标（分支图标）是核心操作入口，它不是只看状态的面板，而是可直接交互的命令中心。
- 修改文件后，会在
CHANGES区域列出，点击文件名左侧的+可暂存（git add），右键支持Stage Selected Ranges暂存选中代码块——这对“部分提交”非常关键 - 暂存区（
STAGED CHANGES）中的文件，点右侧的⋯可Revert Selected Ranges撤销某段暂存内容，或Discard Changes彻底丢弃工作区修改 - 提交时，顶部输入框即为 commit message，支持多行；勾选
Always sign off（在设置中开启git.alwaysSignOff）可自动追加Signed-off-by - 注意：VS Code 默认不启用
git.commitTemplate，如需模板（如规范化的 PR 描述），需在本地仓库.git/config中配置commit.template路径，VS Code 会自动读取
用命令面板快速执行高级 Git 操作
图形界面覆盖不了所有场景，Ctrl+Shift+P 是调用 Git 命令最高效的入口，比写命令行快，又比鼠标点菜单全。
- 输入
Git: Checkout to...切换分支，支持模糊匹配，比手动敲git checkout更安全（不会误删未提交更改） -
Git: Pull (rebase)和Git: Push直接触发同步，避免因忘记--rebase导致污染提交历史 -
Git: Compare With HEAD快速对比当前文件与最新 commit，Git: Compare With Previous Version对比上一版——比右键菜单更快定位变更点 - 遇到冲突时，VS Code 会高亮冲突标记，并在编辑器顶部提供
Accept Current Change/Accept Incoming Change等操作按钮，无需退出编辑器手动编辑
避免 .gitignore 失效和状态延迟的实操细节
VS Code 的文件监视机制有时会让状态滞后，尤其在大量文件变更或网络文件系统上，导致 git status 和 SCM 视图不一致。
- 如果新增文件没出现在
CHANGES，先检查是否被.gitignore拦截：在终端运行git check-ignore -v path/to/file确认匹配规则 - VS Code 默认监视文件变化使用
fs.watch，大仓库可能失效；可在设置中开启git.autoRepositoryDetection并确保files.watcherExclude不误排除.git/** - 强制刷新 SCM 视图：右键
CHANGES区域 →Refresh，或执行命令Git: Refresh；长期卡顿可尝试关闭其他扩展，尤其是那些监听文件系统的插件 - 注意：VS Code 不会自动跟踪符号链接目录下的 Git 仓库，若项目含子模块或 symlink，需手动用
Git: Add Folder to Workspace加入工作区
真正影响效率的往往不是功能多寡，而是对“VS Code 的 Git 是命令行的可视化代理”这一本质的理解——它不替代 git log --graph 或 git rebase -i，但把高频操作压缩到三次按键内。别试图让它做所有事，该开终端时就开终端，该配 .gitconfig 就配，这才是高效的前提。
