PyCharm 2024.3 Help

Group changes into changelists

A changelist is a set of local changes that have not yet been committed to a VCS repository.

With changelists, you can group changes related to different tasks and commit these sets of changes independently. For more information, refer to Commit changes locally.

Changelists are displayed in the Changes view of the Commit tool window Alt+0. Initially, there is a single default changelist called Changes. All new changes are automatically placed in the Changes changelist. There is also an Unversioned Files changelist that groups newly created files that haven't been added to Git yet.

You can create as many changelists as needed and make any of them active at any moment. You can move any uncommitted changes to any changelist.

Create a new changelist

  1. In the Changes view, right-click a file to open the context menu and select New Changelist.

  2. In the New Changelist dialog, specify the name of the new changelist and add a description (optional).

Set the active changelist

  • In the Changes view, 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. In the Changes view, select the changes that you want to move to another changelist.

  2. Right-click the selection and choose Move to Another Changelist Alt+Shift+M.

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

  4. You can choose to make the target changelist active and to track the context for it. PyCharm will remember your workspace setup for that changelist, including open files, caret positions, breakpoints, and run configurations. When you switch back to this changelist later PyCharm will automatically restore these settings.

Delete a changelist

  • Right-click a changelist and choose Delete Changelist from the context menu.

Last modified: 08 October 2024