{"id":235744,"date":"2022-01-06T09:30:46","date_gmt":"2022-01-06T17:30:46","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/visualstudio\/?p=235744"},"modified":"2022-01-06T09:25:46","modified_gmt":"2022-01-06T17:25:46","slug":"introducing-new-git-features-to-visual-studio-2022","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/visualstudio\/introducing-new-git-features-to-visual-studio-2022\/","title":{"rendered":"Introducing new Git features to Visual Studio 2022"},"content":{"rendered":"

We continue to enhance the Git experience in Visual Studio, and we are excited to announce some long-awaited updates in version 17.1 Preview 2. Download the latest Visual Studio Preview and check out the following new Git features.<\/p>\n

Download Visual Studio 2022 Preview<\/a><\/div><\/p>\n\n\n\n\n\n\n\n
New Git features<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
Compare branches<\/strong><\/a><\/td>\nCompare your checked out branch with any local or remote branch.<\/td>\n<\/tr>\n
Checkout commit<\/strong><\/a><\/td>\nCheckout the tip commit or any previous commit of remote and local branches.<\/td>\n<\/tr>\n
Multi-repo branching<\/strong><\/a><\/td>\nManage and create new branches on all of your active repositories at the same time.<\/td>\n<\/tr>\n
Line-staging (interactive staging)<\/strong><\/a><\/td>\nSplit your changes across different commits by staging sections of code changes.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

<\/i>Are you new to Git and source control?<\/strong><\/p>Start utilizing Git and Visual Studio to their full potential by<\/span>\u00a0signing up for the Git learning series<\/a>. <\/div><\/p>\n

 <\/p>\n

Compare branches<\/h3>\n

Comparing branches provides an overview of differences between two branches which can be very helpful before creating a pull request, merging, or even deleting a branch.<\/p>\n

\"Image<\/a><\/p>\n

To compare your currently checked out branch with other branches using Visual Studio, you can utilize the branch picker hosted in the status bar and the Git changes tool window to choose any local or remote branch to compare with. Right click the branch you are targeting and select Compare with Current Branch<\/strong>. Alternatively, you can utilize the branch list on the Git Repository window to access the same command.<\/p>\n

\"Image<\/a><\/p>\n

\"Compare<\/a><\/p>\n

Selecting Compare with Current Branch<\/strong>\u00a0opens the compare branches experience where you can navigate the Changes list and select the file that you would like to compare.<\/p>\n

\"Image<\/a><\/p>\n

<\/i>Tip: use your preferred diff layout<\/strong><\/p>If you prefer an inline diff, you can use the diff configuration options gear and switch to an inline diff view.<\/p>\n

\"Image<\/a><\/p>\n

<\/div><\/p>\n

 <\/p>\n

Checkout commits<\/h3>\n

Checking out a commit can be beneficial in multiple ways. For example, it allows you to go back to a previous point in your repository\u2019s history where you can run or test your code. It can also be helpful if you would like to review code from a remote branch (a colleague’s branch, for example). That way you don\u2019t need to create a local branch if you are not planning on contributing to it. In this case, you can just checkout the tip of the remote branch that you would like to review.<\/p>\n

\"Image<\/a><\/p>\n

To checkout a previous commit in Visual Studio, open the Git Repository window View > Git Repository<\/strong>, right click on the commit you would like to go back to and select checkout (–detach).<\/strong><\/p>\n

\"Image<\/a><\/p>\n

Visual Studio shows a confirmation dialog explaining that by checking out a commit you will be in a detached HEAD state. Meaning that the HEAD of your repository is going to point directly to a commit instead of a branch.<\/p>\n

\"Image<\/a><\/p>\n

Once you confirm your action by clicking Yes<\/strong>, Visual Studio shows a confirmation message and both the Git Repository, and the Git Changes windows show a Detached at a Commit state.\"Image<\/a><\/p>\n

\"Checkout<\/a><\/p>\n

Now that you are in a detached head state, feel free to run and test your code or even explore and commit changes. When you are done exploring and want to go back to your branch, you can choose to discard your changes by checking out an existing branch or choose to keep your changes by creating a new branch<\/a> first.<\/p>\n

<\/i>Important Tip: to keep your changes, create a new branch before exiting the detached HEAD state <\/strong><\/p>Commits created in a detached head state are not associated with any branch and may be garbage collected by Git after you checkout a branch. That is why to keep your changes, it is recommended to create a new branch before checking out a branch. For example, commits C5 and C6 will be garbage collected if we check out Main without creating a new branch.<\/p>\n

\"Image<\/a><\/p>\n

To learn more about the detached head state view the following Git documentation: Detached Head<\/a><\/p>\n

<\/div><\/p>\n

Checking out the tip of a remote branch can be helpful if you would like to quickly review a pull request and evaluate the latest updates. To do that in Visual Studio, first make sure to fetch and get the latest updates from your remote repository Git > Fetch<\/strong>. Then right click on the remote branch you would like to review and select Checkout Tip Commit<\/strong>.<\/p>\n

\"Image<\/a><\/p>\n

<\/i>Note: Uncommitted changes might conflict with the commit you are checking out<\/strong><\/p>You can checkout commits and branches when you have uncommitted changes. Visual Studio detects if there are conflicts between uncommitted changes and the commit\/branch you are checking out and provides an option to keep your changes by reapplying them after the checkout.<\/p>\n

\"Image<\/a><\/p>\n

<\/div><\/p>\n

 <\/p>\n

Multi-repo branching<\/h3>\n

During this release we continued improving the multi-repo support preview feature we introduced in Visual Studio 2022 Preview 3<\/a> by enhancing the inner loop branching experience. The easiest way to enable multi-repo support is to use CTRL+Q, type \u201cpreview\u201d and open the preview features pane. Scroll to \u201cEnable multi-repo support\u201d and toggle the checkbox.<\/p>\n

\"Image<\/a>

<\/i>Note: Open a solution with projects hosted on different Git repositories to get started <\/strong><\/p>Once you enable the multi-repo feature flag and open a solution File > Open > Project\/Solution<\/strong> with projects hosted on different Git repositories, Visual Studio will automatically activate up to 10 repositories at the same time.<\/div><\/p>\n

The branch pickers on both the status bar and the Git Changes tool window now support multi-repo in Visual Studio. You can utilize them to quickly switch between branches and do lightweight branch management across all of your active repositories. To quickly switch between branches of any active repository, expand the repository tree on the branch picker and click on the branch you would like to checkout.<\/p>\n

\"Image<\/a><\/p>\n

You can use both branch pickers for lightweight branch management across your active repositories. Common inner loop branching operations including merge, rebase, rename, delete and compare branches are accessible by right clicking branches on this list. For more advanced repository and branch management operations please use the Git Repository window<\/a>.<\/p>\n

\"Image<\/a><\/p>\n

\"Multi<\/a><\/p>\n

A popular use case for this lightweight branch management experience is to include updates from different remote branches. For example, to merge changes from a colleague’s branch, right click on the branch under the Remotes tab and select Merge into Current Branch<\/strong>.<\/p>\n

\"Image<\/a><\/p>\n

The create new branch experience now supports creating branches across all active repositories. All you need to do is provide a branch name and click the Create branches<\/strong>\u00a0button to create the same new branch on all active repositories! You can also choose to create your new branch on a subset of active repositories by utilizing the checkboxes.<\/p>\n

\"Image<\/a><\/p>\n

If you need your new branches to be based on branches other than your currently checked out branches, you can utilize the branch drop-down to do that. For example, let\u2019s say we need our new branch to be based on the subtract_feature branch on the MathLib repo and based on a different branch on the Multi-rep Calculator repo. In this case, we would use the branch drop-down to select a different branch under the Multi-rep Calculator repo.<\/p>\n

\"Image<\/a><\/p>\n

 <\/p>\n

Line-staging (interactive staging)<\/h3>\n

Line-staging support, a.k.a. interactive staging is one of our most popular Git suggestion tickets<\/a>. Line-staging can be helpful when you need to split changes across different commits. This preview includes few of the Line-staging features that we are still working on enhancing. The easiest way to enable this early version of line-staging support is to use CTRL+Q, type \u201cpreview\u201d and open the preview features pane. Scroll to \u201cEnable line-staging support\u201d and toggle the checkbox.<\/p>\n

\"Image<\/a>

<\/i>Note: line-staging is still a preview feature<\/strong><\/p>This functionality is still a preview feature, which means we are working hard to add more support in the coming releases. In the meantime, we\u2019re depending on your feedback, the community, to build what you need<\/div><\/p>\n

Once you switch on the line-staging preview flag and restart your Visual Studio, you can start staging chunks of your changes by clicking on files in the Git Changes window<\/strong>. Then hover over the sections of code you would like to stage and click Stage Change<\/strong>.<\/p>\n

\"Image<\/a><\/p>\n

\"Image<\/a><\/p>\n

<\/i>Tip: use line-staging with your preferred diff layout<\/strong><\/p>Line-staging is supported on both inline and side-by-side diff modes:<\/p>\n

\"Image<\/a><\/div><\/p>\n

This early version of line-staging support has a number of known issues and limitations.<\/p>\n

Known Issues:<\/strong><\/p>\n