How to Configure Visual Studio as Diff and Merge Tool for Git

after almost six years, the post on how to configure diff and merge tool in visual studio git tools is still read by people that found it useful, but it is now really really old and needs to be updated.

that post was written when visual studio 2012 was the latest version and the integration with git was still really young, made with an external plugin made by microsoft and with really basic support. if you use visual studio 2017 or greater, you can simply go to team explorer and open settings of the repository.

figure 1: git repository settings inside visual studio team explorer figure 2: git settings inside visual studio figure 3: diff and merge tool configuration inside visual studio.

settings pane contains a specific section for git where you can configure settings for the current repository or global settings that are valid for all repositories of the current user.

if you open the repository settings, usually, you find that no specific diff and merge tool is set. merge and diff configurations are typical settings that are made at the user level and not for each individual repository .

as you can see, in figure 3, no diff or merge tool was set for the current repository; this means that it will use the default one for the user (in my situation is none). if you use only visual studio, these settings are not so useful; if you have a conflict during merge or rebase, visual studio will automatically show conflicts and guide you during merging.

if you are inside visual studio, it will handle diff and merge automatically, even if it is not configured as diff or merge tool. the rationale behind this choice is that if you are inside a tool (like vs) that has full support for diff and merge, the tool will automatically present you with diff and merge capabilities without checking repo configuration.

figure 4: git diff and merge section as saved from visual studio 2019 preview

this happens because when you open a git repository, visual studio monitors the status of the repository and, if some operation has unresolved conflicts, it shows the situation to the user without the need to do anything . the settings in figure 3 is useful only if you are operating with some other tool or with the command line. if you got a conflict during an operation started from any other tool (gui or command line), the procedure is:

1. opening vs

2. from vs team explorer, localize the local git repository and open it

3. go to the team explorer changes pane to start resolving conflicts

if you configured instead vs as diff and tool, you can simply issue a git mergetool command and everything will be done automatically without any user intervention.

but to be honest, the latest vs git integration is really good and it is surely better to manually open the local repository. as an example, if you are doing a rebase from the command-line and you got conflicts, it is better to manually open vs, solve the conflict, and then continue to rebase the operation inside vs. if you receive further conflicts, you do not need to wait for vs to reopen it with the git mergetool command.

but if you really want to configure vs as diff and merge tool, if you press "use visual studio" button ( figure 3 ), you can modify your local gitconfig. the net result is similar to what i suggested in my old post, vs just adds the six sections for diff and merge in the config file.

if visual studio is your tool of choice, i simply suggest you configure it globally (file named %userprofile%\.gitconfig ) so you can invoke the merge tool from everywhere and have visual studio handle everything.

hope this helps! let us know your thoughts in the comments below.