PyCharm 2019.3 Help

Manage Changelists

With changelists you can group uncommitted changes to separate parts of your work and commit those parts independenlty.

Changelists in PyCharm is a feature of its integrated VCS client and it has different implementations for different VCSs. For example if you use Git, changelists is a client feature that extends Git functionality, but if you use SVN, the implementation is integrated with the native SVN changelists.

Changelists are displayed in the Local Changes tab of the Version Control window Alt+9. Initially, there is a single Default Changelist. It is displayed in bold to show its active status, which means that all new changes are placed in this changelist. There is also a special Unversioned Files changelist that groups newly created files.

You can create as many changelists as needed and make any of them active at any moment. Any uncommitted change can be moved to the desired changelist.

Create a new changelist

  1. Open the Version Control window Alt+9 and switch to the Local Changes tab.

  2. Click new changelist and select New Changelist.

  3. In the New Changelist dialog, specify the name of the new changelist, and an optional description.

Set the active changelist

  1. Open the Version Control window Alt+9 and switch to the Local Changes tab.

  2. Select a non-active changelist and press Ctrl+Space or right-click it and choose Set Active Changelist from the context menu. All new changes will be automatically placed in this changelist.

Move changes between changelists

  1. Open the Version Control window Alt+9 and switch to the Local Changes tab.

  2. Select the changes that you want to move to another changelist.

  3. Right-click the selection or click the Changelists icon on the toolbar and choose Move to Another Changelist Shift+Alt+M.

  4. In the dialog that opens, select an existing changelist or enter the name for a new changelist.

  5. You can choose to make the target changelist active and to track context for it (PyCharm will save the context associated with this changelist, and will restore it when this changelist becomes active).

Put changes in a single file into different changelists

  1. When you make a change to a file in the editor, click the corresponding change marker in the gutter.

  2. In the toolbar that appears, select the target changelist for the modified code chunk (or create a new changelist):

    Partial commit changelists

Last modified: 10 December 2019