VSCode 内置 Git 集成支持在编辑器内完成仓库初始化、文件暂存与提交、推送至远程、拉取合并及分支切换等全流程版本控制操作。

如果您在使用 VSCode 进行代码开发时希望直接通过编辑器完成版本控制操作,而非切换到终端或外部 Git 客户端,则 VSCode 内置的 Git 集成可实现提交、推送、拉取等核心操作的一体化管理。以下是具体执行方式:
本文运行环境:MacBook Air,macOS Sequoia。
一、启用并初始化 Git 仓库
VSCode 的 Git 功能需在项目根目录存在有效的 Git 仓库才能激活。若当前工作区尚未初始化,需先创建本地仓库或克隆远程仓库。
1、点击左侧活动栏中的源代码管理图标(分支形状图标)。
2、若状态栏显示“未初始化 Git 仓库”,点击提示旁的“初始化仓库”按钮。
3、确认初始化后,VSCode 自动加载 .git 目录,并在资源管理器中显示未暂存文件列表。
二、暂存与提交更改
提交前需将修改的文件加入暂存区,VSCode 提供图形化界面替代 git add 命令,便于逐个或批量选择变更。
1、在源代码管理视图中,展开“暂存的更改”和“未暂存的更改”两个区域。
2、右键单击某文件,在弹出菜单中选择暂存更改,或点击文件旁的加号图标。
3、在顶部输入框中输入提交信息,按 Cmd + Enter(macOS) 执行提交。
三、推送本地提交至远程仓库
推送操作将本地分支的提交同步到关联的远程仓库,要求已配置远程地址且本地分支已跟踪远程分支。
1、点击源代码管理视图右上角的三个点图标,打开更多操作菜单。
2、选择推送,若首次推送,VSCode 会提示是否设置上游分支,点击“是”即可自动关联。
3、推送过程中状态栏显示进度条,完成后显示“已推送 N 个提交”。推送失败时,通常因远程有新提交未拉取,需先执行拉取合并。
四、拉取远程更新并合并
拉取操作从远程仓库获取最新提交,并自动合并到当前本地分支,确保本地代码与远程一致。
1、点击源代码管理视图右上角的三个点图标。
2、选择拉取,VSCode 执行 git pull 命令。
3、若存在冲突,VSCode 会在编辑器中高亮冲突区块,并提供“接受当前更改”“接受传入更改”“接受两者”等快捷操作按钮。
五、切换与管理分支
VSCode 支持可视化分支切换、创建与删除,避免记忆 git checkout 或 git switch 命令。
1、点击底部状态栏中显示的当前分支名称(如 main 或 master)。
2、在弹出面板中选择已有分支进行切换,或点击+ 创建新分支,输入名称并指定起点。
3、创建后立即切换至该分支,所有后续提交均在此分支进行,无需额外命令。










