PyCharm
 
2021.2
Shortcuts: Windows
Get PyCharm
You are viewing the documentation for an earlier version of PyCharm.
  1. Configure PyCharm
  2. Keyboard shortcuts

Configure keyboard shortcuts

Last modified: 02 September 2021

File | Settings | Keymap for Windows and Linux

PyCharm | Preferences | Keymap for macOS

Ctrl+Alt+S the Settings/Preferences icon

PyCharm includes several predefined keymaps and lets you customize frequently used shortcuts.

To view the keymap configuration, open the Settings/Preferences dialog Ctrl+Alt+S and select Keymap.

Keymap settings

PyCharm automatically suggests a predefined keymap based on your environment. Make sure that it matches the OS you are using or select the one that matches shortcuts from another IDE or editor you are used to (for example, Emacs).

You cannot change predefined keymaps. When you modify any shortcut, PyCharm creates a copy of the currently selected keymap, which you can configure. Click The Show Scheme Actions icon to duplicate the selected keymap, rename, remove, or restore it to default values.

note

A custom keymap is not a full copy of its parent keymap. It inherits unmodified shortcuts from the parent keymap and defines only those that were changed. For information about the keymap files, see Location of user-defined keymaps.

The keymap itself is a list of actions with corresponding keyboard and mouse shortcuts, and abbreviations. To find an action by name, type it in the search field. If you know the shortcut of an action, click The Find Action by Shortcut icon and press the key combination in the Find Shortcut dialog.

When consulting this page and other pages in PyCharm documentation, you can see keyboard shortcuts for the keymap that you use in the IDE — choose it using the selector at the top of a page.

tip

To view the keymap reference as PDF, choose Help | Keymap Reference from the main menu.

Add a keyboard shortcut

Add a mouse shortcut

Add an abbreviation

Reset action shortcuts to default

Location of user-defined keymaps

All user-defined keymaps are stored in separate configuration files under the keymaps subdirectory in the PyCharm configuration directory:

Syntax

%APPDATA%\JetBrains\<product><version>\keymaps

Example

C:\Users\JohnS\AppData\Roaming\JetBrains\PyCharm2021.2\keymaps

By default, this directory contains only the default keymaps. When you modify one of them, PyCharm actually creates a child keymap file that contains only the differences relative to the parent keymap. For example, if you modified the default Windows keymap, your custom keymap will be its child. The file will contain only the shortcuts that you added or modified, while all other shortcuts of your custom keymap will be the same as the default Windows keymap.

You can share your custom keymaps with team members or between your IDE instances. Copy the corresponding keymap file and put it in the keymaps directory on another PyCharm installation. Then select the copied keymap on the Keymap settings page.

Conflicts with global OS shortcuts

Predefined keymaps do not cover every possible platform, version, and configuration. Some shortcuts can conflict with global system actions and shortcuts for third-party software. To fix these conflicts, you can reassign or disable the conflicting shortcut.

PyCharm detects conflicts with system shortcuts and notifies you with a popup message:

Notification on conflicting shortcuts

Click Modify shortcuts to open the Keymap settings dialog where you can make the necessary adjustments:

Adjust conflicting shortcuts

Here are a few examples of possible system shortcut conflicts with the default keymap in PyCharm. Make sure that function keys are enabled on your system.

Shortcut

System action

PyCharm action

⌃Space

Select the previous input source

Basic code completion

⇧⌘A

Search man Page Index in Terminal

Find Action

See also

Tips