The extension allows you to compare folders, show the diffs in a list and present diff in a splitted view side by side.
How to use?
There are several ways to choose folders to compare:
- Command Palette -
Compare a folder against workspace choose a folder to compare against the workspace's folder (when workspace is not empty)
Choose 2 folders and compare - opens OS folder chooser twice
- Compare Folders Panel (Click on the icon in the Activity Bar)
Click to select a folder see 1st item
Click to select folders see 2nd item
- File explorer
- Select 2 folders, right click and click on
Compare selected folders see 2nd item
- From history
Pick from recent compares chose one of the pairs you compared in the past.
- (The list can be reset by
Clear recent compares)
Refresh - If there are changes in the compared folders' files, click on the
refresh button will re-compare the folders.
Options (under vscode settings)
excludeFilter - glob string
includeFilter - glob string
compareContent - boolean - Compares files by content
diffViewTitle - One of the options: "name only", "compared path", "full path"
ignoreFileNameCase - boolean - Compare files with the same name but different case
diffLayout - One of the options: "local <> compared" or "compared <> local"
showIdentical - boolean - Whether or not show the identical files panel
useDiffMerge - boolean - Whether or not using
Diff & Merge extension as the Diff viewer. In order to use this option, you should install the extension
folderRight - strings - paths of 2 folders, compare them on the extension load.
By calling the following command from the terminal / command line, the extension will be calling on vscode load and show the differences view
COMPARE_FOLDERS=DIFF code path/to/folder1 path/to/folder2
Read more about the development process
You can find the series of the posts about how this extension developed step by step in medium.com.
Like the extension?
Show your love
Isn't working as expected?
Please create an issue
You can find it here
Activity bar's icon (and more) by Stockio.com
Null icon made from Icon Fonts is licensed by CC BY 3.0
External link icon made by Dave Gandy from www.flaticon.com