In this section:
Basics
This dialog is displayed every time you compare two files, or compare two versions of a file (local changes or changes between local files and their revisions in a remote repository). You can compare files of any types, including binaries and .jar files.
The differences viewer provides a powerful editor that enables code completion, live templates, etc.
Note that you can open the differences viewer without running PyCharm. To do this, execute the following command:
<path to PyCharm executable file> diff <path_1> <path_2>
Diff viewer
Item | Tooltip and Shortcut | Description |
---|---|---|
![]() ![]() |
F7 Shift+F7 | Use these buttons to jump to the next/previous difference.
When the last/first difference is hit, PyCharm suggests to click the arrow buttons F7/Shift+F7 once more and compare other files, depending on the check box in the Diff page. This behavior is available only when the Differences Viewer is invoked from the Version Control tool window. |
![]() ![]() | Compare Previous/Next File
Alt+LeftAlt+Right | Click these buttons to compare the local copy of the previous/next file with its update from the
server.
These buttons are available only when the Differences Viewer is invoked from the Version Control tool window. |
![]() | Go To Changed File Ctrl+N | Click this button to display the path to the compared file.
This button is available only when the Differences Viewer is invoked from the Version Control tool window. |
![]() |
Jump to Source
F4 | Click this button to open the file in the active pane in the editor. The caret will be placed in the same position as in the Differences Viewer. |
Type of viewer | ![]() | Use this drop-down list to choose the desired viewer type. The default viewer has two panels; One-side viewer has one panel only. |
Whitespace | ![]() | Use this drop-down list to define how the differences viewer should treat white spaces in the text.
|
Highlighting mode | ![]() | Select the way differences granularity is highlighted. Possible options are:
|
![]() | Collapse unchanged fragments | Click this button to collapse all unchanged fragments of both files. The amount of non-collapsible unchanged lines is configurable in the page Diff. |
![]() | Synchronize scrolling | Click this button to simultaneously scroll both differences panes; if this button is released, each of the panes can be scrolled independently. |
![]() | Editor settings | Click this button to reveal the drop-down list of available check commands. Select or clear these check commands to show or hide line numbers, indentation guides, white spaces, and soft wraps. |
![]() | Show diff in external tool | Click this button to invoke an external differences viewer, specified in the
External Diff Tools page.
This button only appears on the toolbar, when the check box Use external diff tool is selected in the External Diff Tools page. |
![]() | Help F1 | Click this button to show reference page. |
Ctrl+Tab or Ctrl+Shift+Tab | Use this keyboard shortcut to switch between the panes of the Differences viewer. The active pane has the cursor. | |
![]() ![]() | Use these chevron buttons to apply differences between panes.
The chevron buttons can change their behavior:
| |
Ctrl+Shift+D | Use this keyboard shortcut to show the popup menu of the most required diff commands. |
See Also
Procedures:
- Comparing Files
- Viewing Local History of a File or Folder
- Comparing Deployed Files and Folders with Their Local Versions
Web Resources: