Tutorial

Introduction

Visual Studio Code (VS Code) has become one of the most popular editors out there for web development. It has gained such popularity thanks to its many built-in features such as source control integration, namely with Git. Harnessing the power of Git from within VS Code can make your workflow more efficient and robust.

In this tutorial, you will explore using Source Control Integration in VS Code with Git.

Prerequisites

Version control in VS Code. In this tutorial, we will learn how to use the basics of Git version control in Visual Studio Code. For more information about integrated Git support, including how to work with remote repositories, read on in the related resources section below. Last week we released version 16.6 Preview 2 of Visual Studio 2019. It contained the first iteration of a revamped Git experience to improve your productivity when working with code on GitHub, Azure Repos, and other hosting services. You can learn more about how to use the entire Git feature set in Visual Studio in our new documentation. Code actions to create issues from 'todo' comments. Getting Started. It's easy to get started with GitHub Pull Requests for Visual Studio Code. Simply follow these steps to get started. Install the extension from within VS Code or download it from the marketplace. Open your desired GitHub repository in VS Code. When using git at the command line, I am wondering if it is possible to use Visual Studio Code as the default editor, i.e. When creating commit comments, and looking at a diff of a file from the command line. The following example uses a GitHub host, but you can use any Git host for version control in Visual Studio for Mac. If you wish to use GitHub, make sure that you have an account created and configured before following the steps in this article. Creating a remote repo on GitHub. The following example uses a GitHub host, but you can use any Git.

To complete this tutorial, you will need the following:

  • Git installed on your machine. For more details on accomplishing this, review the Getting Started with Git tutorial.
  • The latest version of Visual Studio Code installed on your machine.
How to use git in visual studio code

Step 1 — Familiarizing with the Source Control Tab

The first thing you need to do to take advantage of source control integration is initialize a project as a Git repository.

Open Visual Studio Code and access the built-in terminal. You can open this by using the keyboard shortcut CTRL + ` on Linux, macOS, or Windows.

In your terminal, make a directory for a new project and change into that directory:

Then, create a Git repository:

Another way to accomplish this with Visual Studio Code is by opening up the Source Control tab (the icon looks like a split in the road) in the left-side panel:

Next, select Open Folder:

This will open up your file explorer to the current directory. Select the preferred project directory and click Open.

Then, select Initialize Repository:

If you now check your file system, you will see that it includes a .git directory. To do this, use the terminal to navigate to your project directory and list all of the contents:

You will see the .git directory that was created:

Now that the repo has been initialized, add a file called index.html.

After doing so, you’ll see in the Source Control panel that your new file shows up with the letter U beside it. U stands for untracked file, meaning a file that is new or changed, but has not yet been added to the repository:

You can now click the plus icon (+) by the index.html file listing to track the file by the repository.

Once added, the letter next to the file will change to an A. A represents a new file that has been added to the repository.

To commit your changes, type a commit message into the input box at the top of the Source Control panel. Then, click the check icon to perform the commit.

After doing so, you will notice that are no pending changes.

Next, add a bit of content to your index.html file.

You can use an Emmet shortcut to generate an HTML5 skeleton in VS Code by pressing the ! key followed by Tab key. Go ahead and add something in the <body> like a <h1> heading and save it.

In the source control panel, you will see that your file has been changed. It will show the letter M next to it, which stands for a file that has been modified:

For practice, go ahead and commit this change as well.

Now that you’re familiar interacting with the source control panel, you will move on to interpreting gutter indicators.

Step 2 — Intepreting Gutter Indicators

In this step you will take a look at what’s called the “Gutter” in VS Code. The gutter is the skinny area to the right of the line number.

Editor

If you’ve used code folding before, the maximize and minimize icons are located in the gutter.

Let’s start by making a small change to your index.html file, such as a change to the content within the <h1> tag. After doing so, you will notice a blue vertical mark in the gutter of the line that you changed. The vertical blue mark signifies that the corresponding line of code has been changed.

Now, try deleting a line of code. You can delete one of the lines in the <body> section of your index.html file. Notice now in the gutter that there is a red triangle. The red triangle signifies a line or group of lines that has been deleted.

Lastly, at the bottom of your <body> section, add a new line of code and notice the green bar. The vertical green bar signifies a line of code that has been added.

Disable git in visual studio code

This example depicts gutter indicators for a modified line, a removed line, and a new line:

Step 3 — Diffing Files

VS Code also has the ability to perform a diff on a file. Typically, you would have to download a separate diff tool to do this, so this built-in feature can help you work more efficiently.

To view a diff, open up the source control panel and double-click a changed file. In this case, double-click the index.html file. You will be brought to a typical diff view with the current version of the file on the left and the previously committed version of the file on the right.

Connect Git In Visual Studio Code

This example shows that a line has been added in the current version:

Step 4 — Working with Branches

Register Git In Visual Studio Code

Moving to the bottom bar, you have the ability to create and switch branches. If you take a look at the very bottom left of the editor, you should see the source control icon (the one that looks like a split in the road) followed most likely by master or the name of the current working branch.

To create a branch, click on that branch name. A menu should pop up giving you the ability to create a new branch:

Go ahead and create a new branch called test.

Now, make a change to your index.html file that signifies you are in the new test branch, such as adding the text this is the new test branch.

Commit those changes to the test branch. Then, click the branch name in the bottom left again to switch back to the master branch.

After switching back to the master branch, you’ll notice that the this is the new test branch text committed to the test branch is no longer present.

Step 5 — Working with Remote Repositories

This tutorial won’t touch on it in-depth, but through the Source Control panel, you do have access to work with remote repositories. If you’ve worked with a remote repository before you’ll notice familiar commands like pull, sync, publish, stash, etc.

Step 6 — Installing Useful Extensions

Not only does VS Code come with lots of built-in functionality for Git, there are also several very popular extensions to add additional functionality.

Git Blame

This extension provides the ability to view Git Blame information in the status bar for the currently selected line.

This may sound intimidating, but not to worry, the Git Blame extension is much more about practicality than it is about making someone feel bad. The idea of “blaming” someone for a code change is less about shaming them, and more about figuring out the right person to ask questions to for certain pieces of code.

As you can see in the screenshot, this extension provides a subtle message related to the current line of code you are working on in the bottom toolbar explaining who made the change and when they made it.

Git History

Although you can view current changes, perform diffs, and manage branches with the built-in features in VS Code, it does not provide an in-depth view into your Git history. The Git History extension solves that issue.

As you can see in the image below, this extension allows you to thoroughly explore the history of a file, a given author, a branch, etc. To activate the Git History window below, right-click on a file and choose Git: View File History:

Additionally, you can compare branches and commits, create branches from commits, and more.

Git Lens

GitLens supercharges the Git capabilities built into Visual Studio Code. It helps you to visualize code authorship at a glance via Git blame annotations and code lens, seamlessly navigate and explore Git repositories, gain valuable insights via powerful comparison commands, and so much more.

The Git Lens extension is one of the most popular in the community and is also the most powerful. In most ways, it can replace each of the previous two extension with its functionality.

For “blame” information, a subtle message appears to the right of the line you are currently working on to inform you of who made the change, when they made it, and the associated commit message. There are some additional pieces of information that pop up when hovering over this message like the code change itself, the timestamp, and more.

For Git history information, this extension provides a lot of functionality. You have easy access to tons of options including showing file history, performing diffs with previous versions, opening a specific revision, and more. To open up these options you can click the text in the bottom status bar that contains the author who edited the line of code and how long ago it was edited.

This will open up the following window:

This extension is packed with functionality, and it will take a while to take in all that it has to offer.

Conclusion

Git Use Visual Studio Code As Default Editor

In this tutorial, you explored how to use source control integration with VS Code. VS Code can handle many features that previously would have required the download of a separate tool.