PyCharm 2016.1 Help

Tuning PyCharm

In this section:

Changing PyCharm properties

PyCharm makes it possible to change *.vmoptions and files without editing them in the PyCharm installation folder.

To create an empty file or to copy *.vmoptions file, choose the Help | Edit Custom Properties or Help | Edit Custom VM Options on the main menu respectively. Refer to the menu items description for details.

Managing *.vmoptions file

For OS X systems: The file /Applications/PyCharm should be copied to ~/Library/Preferences/PyCharm XX/pycharm.vmoptions

For the older versions, the settings are stored in /Applications/PyCharm <version>.app/Contents/Info.plist.

To avoid editing files in the PyCharm installation folder, one should:

  1. Do one of the following:
    • Use the main menu command Help | Edit Custom VM Options to create a copy of the pycharm.vmoptions file in the user home. Refer to Edit Custom VM Options for details.
    • Copy the existing file from the PyCharm installation folder somewhere and save the path to this location in the environment variable PYCHARM_VM_OPTIONS.
    • Copy the existing file <PyCharm installation folder>/bin/pycharm$BITS.vmoptions from the PyCharm installation folder into the location under user home.
  2. Edit this file in the new location.

If PYCHARM_VM_OPTIONS environment variable is defined, or the *.vmoptions file exists, then this file is used instead of the one located in the PyCharm installation folder.

Example: Increasing the heap size

To increase PyCharm heap size, you should copy the original pycharm.vmoptions file to the above-mentioned location, and then modify the -Xmx setting.

Managing file

The file, located in the bin directory of the PyCharm installation folder, should not be edited. Instead of editing the original, create file in the location specified below, open it for editing and add the required properties.

So, depending on your platform:

  • For Windows: in %USERPROFILE%\.PyCharm XX
  • For *NIX: in ~/.PyCharm XX
  • For Mac OS X: in ~/Library/Preferences/PyCharm XX

Example: Changing case of unicode literals

PyCharm allows defining whether non-ascii characters should use literals like '\u00AB' or '\00ab'.

This behavior is controlled by the system property idea.native2ascii.lowercase. By default, upper case characters are used.

If it is desirable to use lower case characters, create the file in the location specified above, open it for editing and add the following line:


Specifying custom JDK, properties or vmoptions files across platforms

A custom JDK, *.properties and *.vmoptions files are specified across platforms in a unified way.

All the launchers look at the following environment variables:


See Also

Last modified: 20 April 2016