Last update:
Using Visual Studio as diff/merge tool in Git and SourceTree
This article was updated for Visual Studio 2017.
Today, a short note on how to set up Visual Studio as a diif and merge tool in SourceTree and Git client. It’s not commonly known that this IDE may be used for resolving merge conflicts, but as you’ll see it’s very simple to set up.
SourceTree config
First, open up the options window and go to Diff tab.
Change both External Diff Tool and Merge Tool to Custom. In the Diff Command field enter the full path to the vsdiffmerge.exe. For VS 2015 and below you can find it in the Visual Studio installation folder, under Common7\IDE subfolder. Visual Studio 2017 has it slightly more hidden. Look under Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer.
As for the arguments fields, type in the following:
Diff tool: "$LOCAL" "$REMOTE" "Source" "Target" //t
Merge tool: "$LOCAL" "$REMOTE" "$BASE" "$MERGED" //m
Click OK, and And that’s it! Now whenever a merge conflict occurs, you’ll be able to resolve it using Visual Studio.
The only downside I found is that vsdifftool may take quite some time to start up. But if you don’t close it after diffing each file, it’ll work like a charm.
Commandline Git config
By saving these settings in SourceTree, your .gitconfig file is updated with two entries: [difftool “sourcetree”] and [mergetool “sourcetree”]. In my case it looks like the following:
1 2 3 4 5 |
[difftool "sourcetree"] cmd = 'C:/Program Files (x86)/Microsoft Visual Studio 2015/Common7/IDE/vsdiffmerge.exe' $LOCAL $REMOTE Source Target //t [mergetool "sourcetree"] cmd = 'C:/Program Files (x86)/Microsoft Visual Studio 2015/Common7/IDE/vsdiffmerge.exe' $LOCAL $REMOTE $BASE $MERGED //m trustExitCode = true |
You can now use these to tell the commandline Git to use these when viewing a diff or merging. It’s as simple as executing two git commands:
git config --global diff.tool sourcetree
git config --global merge.tool sourcetree
Now, git difftool
and git merge
commands will launch Visual Studio.
Doing so is of course perfectly possible even without SourceTree. Just add the difftool and mergetool entries to your .gitconfig file (it should be located in your home folder) and execute the two git config commands shown above.
This was just what I was looking for! Thank you
Perfect. I was wondering how to set this up explicitly in SourceTree
thanks for this! I’m clueless with the command line so wasn’t sure of the syntax needed for the command and paramaters (quotes, how do they work?)
so this came in very handy.
I’m glad I could help.
Can I use it without using installing visual studio?
I’m not aware of a vsdiffmerge version that you can use standalone, without the full VS install. It’s most likely impossible, as it basically is a feature of VS.
Perfect. It is successes on windows.
But if on Mac Pro, How can i config it.
Thank you very mach.
I’m not aware of any built-in diff/merge tool in VS for Mac, unfortunately.
Great, thank you very much (y)
To save someone a bit of time – the VS2017 path may differ if you have VS 2017 Enterprise.
My path is: C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\vsDiffMerge.exe
For others looking, VS2019’s location is C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\vsdiffmerge.exe
Great, thank you very much (y)
Fantastic! This still works as of today for Visual Studio 2019 (VS2019).
Thanks for this! I prefer using the vs merge tool — glad to see there is an easy integration to use it alongside sourcetree for my non-vs project.