PyCharm 2023.2 Help

Invalidate caches

PyCharm caches a great number of files for all projects that you have ever worked with in this IDE version, therefore, the system cache may become overloaded. Sometimes the caches will never be needed again, for example, if you work with frequent short-term projects.

When you invalidate the cache, PyCharm removes the cache files for all projects ever run in the current version of the IDE. The files will be recreated the next time you open these projects.

Clear system cache

  1. Select File | Invalidate Caches from the main menu.

  2. In the Invalidate Caches dialog, you can select additional actions that the IDE will perform while removing the cache files:

    • Clear file system cache and Local History: remove the virtual file system cache together with the information stored in Local History.

      This action might be helpful for troubleshooting purposes when the usual cache invalidation is not enough to solve the problem.

    • Clear VCS Log caches and indexes: remove the cache and indexes of the VCS Log.

      Enable this option if you are certain that your VCS Log indexes are broken, for example, if the Log search doesn't work correctly.

    • Mark downloaded shared indexes as excluded: clear the downloaded shared indexes and place them in the list of excluded files. It means that PyCharm won't re-download the excluded shared indexes.

    • Ask before downloading new shared indexes: show a notification prompting you to download new shared indexes as they become available.

      Enabling this option also updates your settings for shared project indexes in Settings/Preferences | Tools | Shared Indexes.

    • Delete embedded browser engine cache and cookies: remove the cache files and cookies that are stored in the built-in JCEF browser.

      These files rarely get broken. This option allows you to invalidate the cache while keeping JCEF cookies and caches intact.

  3. Click Invalidate and Restart.

    the Invalidate Cache dialog

    If you click Just restart, cache files won't be deleted, and the selected optional actions won't be applied.

For more information about storage of various user-specific files, refer to Directories used by the IDE.

Last modified: 11 September 2023