PyCharm 2019.2 Help

Configuring Project and IDE Settings

Project settings refer to a set of preferences related to resources, file colors, version control options, code styles, and so on. Project settings are stored with each specific project as a set of xml files under the .idea folder.

You can configure project settings on the two possible levels:

  • The level of a template project. The settings defined for a template project, apply to any project you create.

  • The project level. Settings defined on this level apply to the current project only.

In PyCharm, you can configure settings and structure on two levels — the project level and the IDE level.

Project-level settings and structure

The project level settings and structure are applied to the current project only. These settings are stored together with other project files in the .idea directory.

If your project is under a version control, it is recommended that you store XML files with project-specific settings (the .idea folder inside the project folder) under version control, the exception being workspace.xml and tasks.xml, which store user-specific settings.

You can refer to JetBrains.gitignore on GitHub to see what should be ignored.

Access the project-level settings

Select File | Settings for Windows and Linux, or PyCharm | Preferences for macOS.

Alternatively, press Ctrl+Alt+S, or use the Settings icon on the toolbar.

In the Settings/Preferences dialog, that opens, project-level settings are marked with the Project configurable icon.

IDE-level (global) settings and structure

The IDE level (global) settings and structure are applied to all newly created projects. The list of the IDE-level settings contains less options, but it enables you to change the editor settings, create custom scopes, configure inspections, set VCS-specific settings, and so on.

If you want to share the IDE settings between already existing projects, you can use the Settings Repository or the Settings Sync plugin. You can also export the settings to a ZIP archive and import it later to other IDE instances. However, note that the settings import may not work correctly if you already use the Settings Repository or the Sync plugin.

Access the IDE-level settings

From the main menu, select File | Settings for New Projects for Windows and Linux, or File | Preferences for New Projects for macOS.

Restore the default settings

To restore the PyCharm default settings, you can remove the configuration directory idea.config.path when the IDE is not running. The directory is located in:

<SYSTEM DRIVE>\Users\<USER ACCOUNT NAME>\.<PRODUCT><VERSION>

~/Library/Preferences/<PRODUCT><VERSION>

Note that the Library folder may be hidden in the Finder.

~/.<PRODUCT><VERSION>

For more information, refer to Directories used by the IDE to store settings, caches, plugins and logs.

Monitor the IDE performance

In case of performance issues, you can use Activity Monitor to track the percentage of CPU consumed by various subsystems and plugins.

From the main menu, select Help | Activity Monitor. It lists all subsystems and plugins that are consuming CPU at the moment, and arranges them by how much %CPU they are using.

Last modified: 14 August 2019

See Also