PyCharm 2018.1 Help

File Encodings

File | Settings | Editor | File Encodings for Windows and Linux
PyCharm | Preferences | Editor | File Encodings for macOS
Ctrl+Alt+S settings


Use this settings page to configure encoding options globally, for the current project, or for any file or directory in your project.

The file or directory encodings take precedence over the project encoding, which, in turn, takes precedence over the global encoding.

If the file or directory encodings are not defined, then the project encoding is used. If the project encoding cannot be taken (for example, if a project is not yet created), then the global encoding is used.

ItemDescription
Global Encoding From this drop-down list, choose the encoding that should be used by default if no other encoding options are specified. The encoding will be applied, for example, when you specify settings of a default project or check out sources from a version control storage. Choose System Default to have the default encoding of your operating system used or choose a specific encoding.
Project EncodingFrom this drop-down box, choose the default encoding to use in the folders for which no encoding is appointed in the Default encoding field below. Choose System Default to have the default encoding of your operating system used or choose a specific encoding.
File/DirectoryThis column displays the project tree view.
Default encodingThis column displays encoding for a file or directory, if applicable. If encoding is defined within a file, it cannot be configured, and is shown in grey font. If encoding is configurable, click the Default Encoding column for a selected file or directory, and choose encoding from the drop-down list.

Encoding information embedded in a file overrides the selected one; encoding information for the nested files or directories overrides that for the outer directories or the whole project.

Default encoding for properties files Use this drop-down list to define encoding for the properties files in the project.
Transparent native-to-ascii conversion Select this option to show in properties files the national characters (non-ISO 8859-1), stored as escape sequences. If this checkbox is not selected, the national characters will not be shown.
Create UTF-8 files Use this selector to choose how PyCharm should create UTF-8 files: with byte order mark (BOM), without BOM, or BOM only for Windows. It might be helpful if you are working with the OS other than Windows and want more flexibility for the UTF-8 file encoding. Keep in mind that the UTF-8 with BOM option may cause problems with software which is not compatible with BOM or with scripts that need to be run by an interpreter.
Last modified: 23 July 2018

See Also