Skip to main content Link Search Menu Expand Document (external link)

Dictionaries

The spell checker includes a set of default dictionaries.

Use the trace command to see a list of dictionaries: See Searching Dictionaries

General Dictionaries

  • en_US - Derived from Hunspell US English words.
  • en-gb - Derived from Hunspell GB English words.
  • companies - List of well known companies
  • softwareTerms - Software Terms and concepts like “coroutine”, “debounce”, “tree”, etc.
  • misc - Terms that do not belong in the other dictionaries.

Programming Language Dictionaries

  • typescript - keywords for TypeScript and JavaScript
  • node - terms related to using nodejs.
  • php - php keywords and library methods
  • go - go keywords and library methods
  • python - python keywords
  • powershell - powershell keywords
  • html - html related keywords
  • css - css, less, and scss related keywords
  • cpp - C++ related keywords
  • csharp - C# related keywords
  • latex - LaTex related words
  • bash - Bash/shell script keywords

Miscellaneous Dictionaries

  • fonts - long list of fonts - to assist with css
  • filetypes - list of file typescript
  • npm - list of top 500+ package names on npm.

Dictionary Definition

  • name - The reference name of the dictionary, used with program language settings
  • description - Optional description
  • path - Path to the file, can be relative or absolute. Relative path is relative to the current cspell.json file.
  • repMap - Optional replacement map use to replace character prior to searching the dictionary. Example:
        // Replace various tick marks with a single '
        "repMap": [["'|`|’", "'"]]
    
  • useCompounds - Deprecated - allow all possible combinations of words in the dictionary.
// Define each dictionary.  Relative paths are relative to the config file.
"dictionaryDefinitions": [
    { "name": "spanish", "path": "./spanish-words.txt"},
    { "name": "ruby", "path": "./ruby.txt"},
    { "name": "company-terms", "path": "./corp-terms.txt"}
],

Disabling a Dictionary

It is possible to prevent a dictionary from being loaded. This is useful if you want to use your own dictionary or just turn off an existing dictionary.

Disable Default cpp Dictionary

"dictionaries": ["!cpp"],
"overrides": [
  {
      "filename": "legacy/**/*.cpp",
      "dictionaries": ["!!cpp"], // add it back for *.cpp files under the legacy folder
  },
]

The number of !’s is important.

  • !cpp remove cpp dictionary
  • !!cpp add it back
  • !!!cpp remove it again.