PyCharm
 
2022.1
Shortcuts: Windows
Get PyCharm
You are viewing the documentation for an earlier version of PyCharm.
  1. Work with source code
  2. Natural languages
  3. Spellchecking

Spellchecking

Last modified: 17 March 2022

Configure: Settings/Preferences | Editor | Natural Languages | Spelling

Inspection: Settings/Preferences | Editor | Inspections | Proofreading | Typo

PyCharm helps you make sure that all your source code, including variable names, textual strings, comments, literals, and commit messages, is spelt correctly. For this purpose, PyCharm provides a dedicated Typo inspection which is enabled by default.

https://resources.jetbrains.com/help/img/idea/2022.1/py_typo_change_to.png
Gif

In textual strings and comments, only the spelling of this particular word at caret changes. Where the Rename refactoring is available, the inspection suggests to rename all occurrences of a symbol .

The Typo inspection detects and highlights words not included in any dictionary. You can either correct the spelling or accept the word as correct. Disable the Typo inspection if you want to ignore all spelling mistakes. For more information, see Disable spellchecking.

Correct a misspelled word

  1. Place the caret at any word highlighted by the Typo inspection.

  2. Click the Intention action button or press Alt+Enter to show the available intention actions.

  3. Select one of the suggested fixes from the list.

To jump to the next misspelled word, press F2.

Accept a misspelled word

  1. Place the caret at a word highlighted by the Typo inspection.

  2. Click Intention action icon or press Alt+Enter to show the available intention actions.

  3. Select the Save to dictionary action to add the word to the user's dictionary and skip it in the future.

    If you have added the word by mistake, press Ctrl+Z to remove it from the dictionary

By default, PyCharm saves words to the global application-level dictionary. You can choose to save words to the project-level dictionary if the spelling is correct only for this particular project. For more information, see Select the default dictionary for saving words.

Configure the Typo inspection

By default, the Typo inspection checks all text including code elements, string literals, and comments in all scopes.

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | Inspections.

  2. Expand the Proofreading node and click Typo in the central pane.

  3. In the right-hand pane, configure the Typo inspection:

    Severity

    Specify the severity level and the scope in which to apply this level.

    For example, if you want typos to stand out more, select Error or Warning to highlight typos similar to syntax errors or warnings in your code.

    Options

    Specify the type of content to check:

    • Process code: check various code elements.

    • Process literals: check text inside string literals.

    • Process comments: check text inside comments.

Disable spellchecking

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | Inspections.

  2. Clear the checkbox next to the Typo inspection.

Dictionaries

PyCharm includes bundled dictionaries for all configured languages. You cannot modify them directly but you can extend the spellchecker in other ways:

  • Save words to a built-in global or project dictionary.

  • Add plain-text files with the .dic extension that contain lists of words.

  • If you have the Hunspell plugin installed and enabled, you can add Hunspell dictionaries, which comprise of two files: the DIC file that contains a list of words with the applicable modification rules and the AFF file that lists prefixes and suffixes regulated by a specific modification rule. For example, en_GB.dic and en_GB.aff.

Configure the spellchecker dictionaries

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | Natural Languages | Spelling.

  2. Configure the list of custom dictionaries:

    • To add a new custom dictionary to the list, click the Add button or press Alt+Insert and specify the location of the required file.

    • To edit the contents of a custom dictionary in PyCharm, select it and click the Edit button or press Enter. The corresponding file will open in a new editor tab.

    • To remove a custom dictionary from the list, select it and click the Remove button or press Alt+Delete.

Select the default dictionary for saving words

By default, PyCharm saves words to the global application-level dictionary. You can choose to save words to the project-level dictionary if the spelling is correct only for this particular project.

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | Natural Languages | Spelling.

  2. Select either the built-in project-level or application-level dictionary or disable the option to prompt you every time you save a word.

Add accepted words manually

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | Natural Languages | Spelling.

  2. Add words to the Accepted words list. PyCharm adds manually accepted words to the project-level dictionary.

    You can't add words that are already present in one of the dictionaries and mixed-case words, such as CamelCase and snake_case.

tip

The Accepted words list also contains words that you saved to either the built-in global or project dictionary. Although it does not contain words added to the project-level dictionary by other users and words from other custom dictionaries, the Typo inspection will not highlight them.