PyCharm 2024.2 Help

Compare deployed files and folders with their local versions

The correspondence between files and folders in your PyCharm project and their versions on a server is set through deployment server mappings. For the sake of simplicity, any file or folder in your PyCharm project is called local and any file or folder on the server is called remote, even if the server is actually installed on your machine. For more information, refer to Connect to a web server.

Access a server

  1. Open the Remote Host tool window by choosing Tools | Deployment | Browse Remote Host or View | Tool Windows | Remote Host from the main menu.

  2. Select the required deployment server from the list. The tool window shows a tree view of files and folders under the server root. If no relevant server is available in the list, click the Browse button, and in the Deployment dialog that opens configure access to the required server.

Comparing files and folders on the server with their local versions

Each remote file or folder is mapped to one and only one local file or folder. Therefore, for each remote file or folder, PyCharm detects its local version, so you can compare them at any time in the Diff Viewer.

Compare a remote file with its local version

  1. Open the Remote Host tool window (Tools | Deployment | Browse Remote Host or View | Tool Windows | Remote Host) and select the required deployment server from the list.

  2. Select the file, and then select Compare with local version from its context menu.

  3. In the Diff Viewer for Files dialog that opens, explore the differences and apply them, if necessary, using the Replace from right button. For more information, refer to Viewing Differences Between Files.

Compare a remote folder with its local version

  1. Open the Remote Host tool window (Tools | Deployment | Browse Remote Host or View | Tool Windows | Remote Host) and select the required deployment server from the list.

  2. Select the folder and choose Sync with local from the context menu of the selection.

  3. In the Diff Viewer for Folders that opens, explore the differences and synchronize the files, where applicable. See comparing two folders in the Diff Viewer.

Comparing local files and folders with their versions on the server

Because a local file or folder can be mapped to an unlimited number of remote counterparts, PyCharm can uniquely identify remote versions of local files or folders only when they are mapped through the default deployment server. If no such default deployment server is appointed, you have to choose the relevant configuration manually. Note that server groups are displayed in the server selection list only for consistency purposes: currently, it is not possible to compare local files with the ones deployed to a server group.

Compare a local file with its remote version

  1. Select the file in the Project tool window.

  2. In the context menu, select Deployment | Compare with Deployed Version on <default server access configuration> if a default server is appointed. Otherwise, select Sync with Deployed to and then choose the relevant server from the list.

  3. In the Diff Viewer for Files dialog, that opens, explore the differences and apply them, if necessary, using the Apply from right icon button. For more information, refer to Viewing Differences Between Files.

Compare a local folder with its remote version

  1. Select the folder in the Project tool window.

  2. From the context menu of the selection, choose Sync with Deployed to <default deployment server> if a default server is appointed. Otherwise, choose Sync with Deployed to and then choose the relevant server from the list.

  3. In the Diff Viewer for Folders that opens, explore the differences and synchronize the files, where applicable. See comparing two folders in the Diff Viewer.

Compare locally changed files with their remote versions

  1. Switch to the Changes view (Alt+0) to view the locally changed files.

  2. Right-click a file, then select Deployment | Compare with Deployed to from the context menu, and choose the target deployment server from the list. If the default server group is appointed, you can also select Compare with Deployed to <default deployment server>.

For more information, refer to Add files to Git and track changes.

Compare the files synchronized with a VCS repository with their remote versions

  1. Synchronize the contents of your local files with the VCS repository by pressing Ctrl+T or selecting VCS | <VCS> | Update from the main menu.

  2. Switch to the Update Info tab of the Version Control tool window Alt+9.

  3. Right-click a file, then select Deployment | Compare with Deployed to from the context menu, and choose the target deployment server from the list. If the default server is appointed, you can also select Compare with Deployed to <default deployment server>.

Comparing and synchronizing two folders in the Diff Viewer

PyCharm provides a dedicated Diff Viewer for Folders for comparing files in remote folders and their local versions against the file size, content, or timestamp. Besides exploring differences, the tool also provides interface for synchronizing the contents of folders.

  • The Item List shows the contents of the local and remote folders. Use the toolbar buttons to narrow down or widen the set of items to show. For example, show or hide files that are present only locally or remotely, equal files, different files, files excluded from synchronization, and so on.

  • The contents of the remote folder are always shown in the right pane, and the contents of its local version are always shown in the left pane.

  • The contents of the selected file are shown in the lower pane, with the differences being color-highlighted. The remote files in the Diff Viewer have the read-only status. This means that you cannot update them directly in the Diff Viewer. Make all the necessary changes to the local version of the file and upload the updated file to the server.

Compare two folders

  1. Specify the parameter for comparison. In the Compare by list, select one of the possible options (contents, size, or time stamp).

  2. Filter the folders' contents. To do that, type filtering string in the Filter field, and press Enter to apply it. Using the asterisk * wildcard to represent any number of characters is welcome.

  3. To switch to another pair of folders to compare, update the fully qualified paths to them. Click the Browse button next to the Paths read-only fields and choose the required folders in the dialog that opens.

  4. Explore the detected differences between files in the Differences Pane.

    Comparing folders

Synchronize the contents of two folders

  1. For each pair of items, the icon in the * field specifies the action to apply. Click the icon in the field until the required action is set.

    • Icon arrow right  the file will be uploaded, possibly overwriting the remote version.

    • Icon arrow left  the file will be downloaded, possibly overwriting the local version.

    • Icon equal  the files are treated identical with regard to the selected criterion of comparison. No action will be performed by default.

    • Icon not equal  the files differ with regard to the selected criterion of comparison. No action will be performed by default. Explore the differences in the Differences Pane of the Diff Viewer and change the intended action by clicking the icon.

    • Close  the file is present only locally or remotely and will be removed.

  2. Do one of the following:

    • To synchronize the currently selected item, click the Synchronize Selected button Synchronize Selected on the toolbar.

    • To synchronize all the items, click the Synchronize All button Synchronize All on the toolbar.

Last modified: 28 June 2024