VSCode中使用Git进行版本控制的详细操作指南

在 VS Code 中使用 Git 进行版本控制

想直接在编辑器里搞定代码的版本管理吗？VS Code 内置的 Git 支持让这件事变得异常顺手。下面我们就来手把手过一遍核心操作，保证你看完就能用起来。

（本文操作参考了官方文档：Using Version Control in VS Code）

初始化(init)：迈出第一步

这步是干什么的？ 简单说，就是把你的普通项目文件夹，变成一个 Git 能管理的仓库。本质上，就是在文件夹里创建一个隐藏的 .git 目录。

具体怎么操作？有两种主流方法，任你挑选。

方法一：用命令面板

• 首先，用 code 命令或 VS Code 打开你的项目文件夹。
• 唤出命令面板（Ctrl+Shift+P），输入 ‘git init’，然后回车。

  

方法二：用源代码管理视图

• 同样，先打开你的项目文件夹。
• 切换到源代码管理视图（Ctrl+Shift+G）。
• 你会看到一个醒目的 Initialize Repository 按钮，点击它就行了。

  

克隆(clone)：把远程仓库搬回家

如果你需要的是别人已有的代码库，克隆就是最佳选择。打开 VS Code 后，按下面任意一种方式操作。

方法一： 打开命令面板（Ctrl+Shift+P），输入 ‘git clone’，回车。
方法二： 切换到源代码管理视图（Ctrl+Shift+G），点击 Clone Repository 按钮。

接着，在弹出的输入框里，粘贴你要克隆的仓库 URL。

• 然后，选择一个本地文件夹来存放这个仓库。

• 最后，静静等待克隆完成即可。

提交(Commit)：保存你的工作快照

光说不练假把式。为了让大家更清晰地理解提交流程，我们往仓库里添加一个简单的 C++ 源文件 “main.cpp”，内容如下：

// main.cpp
#include 
using namespace std;

int main(){
    cout << "Hello world" << endl;
    return 0;
}

文件创建并保存后，切换到源代码管理视图（Ctrl+Shift+G）。

你会看到未跟踪的文件列表。点击文件右侧的 “+” 号，这个操作叫做“暂存”（Stage），意思是将文件的修改准备放入暂存区（Stage Area），为提交做准备。

暂存之后，点击视图上方的 “√” 对勾图标，在弹出的输入框里，认真填写这次修改的日志信息（比如“添加初始的Hello World程序”），然后回车确认提交。

现在，我们修改一下 “main.cpp” 的内容并保存，再次提交。除了上面的图形化方式，你也可以完全使用命令面板来操作，这对键盘党来说更高效：

打开命令面板（Ctrl+Shift+P），输入 “git Stage”，选择 Git: Stage All Changes 来暂存所有更改。

接着，再次打开命令面板，输入 “git ca”，选择 Git: Commit All 来提交所有已暂存的更改。

同样，输入本次的修改日志并回车，就完成了一次提交。

版本比对：看清每一次变化

这功能有什么用？ 它能让你清晰地看到某个文件在提交前后的具体改动，甚至能比较任意两个历史版本之间的差异。

一个关键提示： “时间线”功能藏在资源管理器视图里，而不是源代码管理视图，第一次用可得找对地方！

1. 比对单个文件的提交前后差异

切换到资源管理器视图（Ctrl+Shift+E），在视图下方（通常在主界面的左下角），你能找到 时间线（TIMELINE）分组。

点击时间线里的任意一个版本记录，右侧编辑器就会立刻展示出该文件在那个版本时的内容，并与当前版本进行差异对比。

再次强调： 时间线分组在资源管理器视图中，不在源代码管理视图中！

2. 比对任意两个历史版本间的差异

这个操作更灵活。先在时间线里选中一个版本作为基准，然后在另一个想对比的版本上点击右键，选择 “Compare with Selected”。这样，两次提交之间的文件差异就一目了然了。

需要注意的是，在时间线里进行版本比对时，打开的文件是只读状态，不能直接编辑。这其实是个保护机制，防止你不小心改了历史版本。

3. 边比对边修改（真正的实用技巧）

那么，如果想参照历史版本修改当前文件怎么办？有个更趁手的办法：直接打开文件（比如 “main.cpp”），在编辑器右侧的快捷工具条里，点击 Open Changes 按钮。

这时，编辑器会并排显示差异，而你当前的工作文件是可以直接编辑的，真正做到了一边比对历史，一边完善代码，效率翻倍。