PyCharm 2020.1 Help

Project and IDE Settings

There are two types of preferences that define your preferred environment:

  • Project preferences, that apply to a specific project. In the Settings/Preferences dialog Ctrl+Alt+S, they are marked with the Current Project icon.

  • IDE preferences, that are common for all projects and refer to the project-independent aspects.

Project preferences

Project preferences are stored with each specific project as a set of .xml files under the .idea folder. If you specify the template project settings, these settings will be automatically used for each newly created project.

The settings that pertain to a project, are marked with the icon the Current Project icon in the Settings/Preferences dialog.

IDE preferences

IDE preferences are stored in the dedicated directories under PyCharm home directory. The PyCharm directory name is composed of the product name and version.

For example:

Windows
  • <User home>\.PyCharmXX\config that contains user-specific settings.

  • <User home>\.PyCharmXX\system that stores PyCharm data caches.

<User home> in WindowsXP is C:\Documents and Settings\<Username>\; in Windows Vista it is C:\Users\<Username>\

Linux
  • /.PyCharmXX/config that contains user-specific settings.

  • ~/.PyCharmXX/system that stores PyCharm data caches.

macOS
  • ~/Library/Application Support/PyCharmXX contains the catalog with plugins.

  • ~/Library/Preferences/PyCharmXX contains the rest of the configuration settings.

  • ~/Library/Caches/PyCharmXX contains data caches, logs, local history, and so on. These files can be quite significant in size.

  • ~/Library/Logs/PyCharmXX contains logs.

Locations of directories

The config directory has several subfolders that contain .xml files with your personal settings. You can easily share your preferred keymaps, color schemes, and so on by copying these files into the corresponding folders on another PyCharm installation. Prior to copying, make sure that PyCharm is not running, because it can erase the newly transferred files before shutting down.

The following is the list of some of the subfolders under the config folder, and the settings contained therein.

Folder nameUser preferences
codestylesContains code style schemes.
colorsContains editor colors and fonts customization schemes.
filetypesContains user-defined file types.
inspectionContains code inspection profiles.
keymapsContains PyCharm keyboard shortcuts customizations.
optionsContains various options, for example, feature usage statistics and macros.
templatesContains user-defined live templates.
toolsContains configuration files for the user-defined external tools.
shelfContains shelved changes.

Locations of the config, system, and plugins directories can be modified in idea.properties file. For more information, see Platform properties.

Last modified: 08 May 2020