- Code Spell Checker
- Languages and Dictionaries
- Reporting and Display
- Files, Folders, and Workspaces
- Performance
- CSpell
- Appearance
- Advanced
- Experimental
- Legacy
Setting | Scope | Description |
---|---|---|
cSpell.enabled |
resource | Enable / Disable the spell checker. |
Name
: cSpell.enabled
Type : boolean
Scope : resource
Description : Enable / Disable the spell checker.
Default
: true
Setting | Scope | Description |
---|---|---|
cSpell.caseSensitive |
resource | Determines if words must match case and accent rules. |
cSpell.customDictionaries |
resource | Custom Dictionaries |
cSpell.dictionaries |
resource | Optional list of dictionaries to use. |
cSpell.dictionaryDefinitions |
resource | Dictionary Definitions |
cSpell.flagWords |
resource | List of words to always be considered incorrect. Words found in flagWords override words . |
cSpell.ignoreWords |
resource | A list of words to be ignored by the spell checker. |
cSpell.language |
resource | Current active spelling language. |
cSpell.languageSettings |
resource | Additional settings for individual programming languages and locales. |
cSpell.noSuggestDictionaries |
resource | Optional list of dictionaries that will not be used for suggestions. Words in these dictionaries… |
cSpell.suggestWords |
A list of suggested replacements for words. Suggested words provide a way to make preferred… | |
cSpell.userWords |
resource | Words to add to global dictionary -- should only be in the user config file. |
cSpell.words |
resource | List of words to be considered correct. |
Name
: cSpell.caseSensitive
Type : boolean
Scope : resource
Description : Determines if words must match case and accent rules.
- `false` - Case is ignored and accents can be missing on the entire word.
Incorrect accents or partially missing accents will be marked as incorrect.
Note: Some languages like Portuguese have case sensitivity turned on by default.
You must use `#cSpell.languageSettings#` to turn it off.
- `true` - Case and accents are enforced by default.
Default : - none -
Name
: cSpell.customDictionaries
-- Custom Dictionaries
Type : object
Scope : resource
Description
: Define custom dictionaries to be included by default.
If addWords
is true
words will be added to this dictionary.
**Example:**
```js
"cSpell.customDictionaries": {
"project-words": {
"name": "project-words",
"path": "${workspaceRoot}/project-words.txt",
"description": "Words used in this project",
"addWords": true
},
"custom": true, // Enable the `custom` dictionary
"internal-terms": false // Disable the `internal-terms` dictionary
}
```
Default : - none -
Name
: cSpell.dictionaries
Type : string[]
Scope : resource
Description : Optional list of dictionaries to use.
Each entry should match the name of the dictionary.
To remove a dictionary from the list add `!` before the name.
i.e. `!typescript` will turn off the dictionary with the name `typescript`.
Example:
```jsonc
// Enable `lorem-ipsum` and disable `typescript`
"cSpell.dictionaries": ["lorem-ipsum", "!typescript"]
```
Default : - none -
Name
: cSpell.dictionaryDefinitions
-- Dictionary Definitions
Type : []
Scope : resource
Description
: Define custom dictionaries..
If addWords
is true
words will be added to this dictionary.
This setting is subject to User/Workspace settings precedence rules: [Visual Studio Code User and Workspace Settings](https://code.visualstudio.com/docs/getstarted/settings#_settings-precedence).
It is better to use `#cSpell.customDictionaries#`
**Example:**
```js
"cSpell.dictionaryDefinitions": [
{
"name": "project-words",
"path": "${workspaceRoot}/project-words.txt",
"description": "Words used in this project",
"addWords": true
}
]
```
Default : - none -
Name
: cSpell.flagWords
Type : string[]
Scope : resource
Description
: List of words to always be considered incorrect. Words found in flagWords
override words
.
Format of `flagWords`
- single word entry - `word`
- with suggestions - `word:suggestion` or `word->suggestion, suggestions`
Example:
```ts
"flagWords": [
"color: colour",
"incase: in case, encase",
"canot->cannot",
"cancelled->canceled"
]
```
Default : - none -
Name
: cSpell.ignoreWords
Type : string[]
Scope : resource
Description : A list of words to be ignored by the spell checker.
Default : - none -
Name
: cSpell.language
Type : string
Scope : resource
Description : Current active spelling language.
Example: "en-GB" for British English
Example: "en,nl" to enable both English and Dutch
Default
: "en"
Name
: cSpell.languageSettings
Type : object[]
Scope : resource
Description : Additional settings for individual programming languages and locales.
Default : - none -
Name
: cSpell.noSuggestDictionaries
Type : string[]
Scope : resource
Description : Optional list of dictionaries that will not be used for suggestions. Words in these dictionaries are considered correct, but will not be used when making spell correction suggestions.
Note: if a word is suggested by another dictionary, but found in
one of these dictionaries, it will be removed from the set of
possible suggestions.
Default : - none -
Name
: cSpell.suggestWords
Type : string[]
Scope :
Description : A list of suggested replacements for words. Suggested words provide a way to make preferred suggestions on word replacements. To hint at a preferred change, but not to require it.
Format of `suggestWords`
- Single suggestion (possible auto fix)
- `word: suggestion`
- `word->suggestion`
- Multiple suggestions (not auto fixable)
- `word: first, second, third`
- `word->first, second, third`
Default : - none -
Name
: cSpell.userWords
Type : string[]
Scope : resource
Description : Words to add to global dictionary -- should only be in the user config file.
Default : - none -
Name
: cSpell.words
Type : string[]
Scope : resource
Description : List of words to be considered correct.
Default : - none -
Setting | Scope | Description |
---|---|---|
cSpell.autoFormatConfigFile |
window | Auto Format Configuration File |
cSpell.diagnosticLevel |
resource | Set Diagnostic Reporting Level |
cSpell.diagnosticLevelFlaggedWords |
resource | Set Diagnostic Reporting Level for Flagged Words |
cSpell.diagnosticLevelSCM |
resource | Set Diagnostic Reporting Level in SCM Commit Message |
cSpell.hideAddToDictionaryCodeActions |
resource | Hide the options to add words to dictionaries or settings. |
cSpell.maxDuplicateProblems |
resource | The maximum number of times the same word can be flagged as an error in a file. |
cSpell.maxNumberOfProblems |
resource | Controls the maximum number of spelling errors per document. |
cSpell.minWordLength |
resource | The minimum length of a word before checking it against a dictionary. |
cSpell.numSuggestions |
resource | Controls the number of suggestions shown. |
cSpell.showAutocompleteDirectiveSuggestions |
language-overridable | Show CSpell in-document directives as you type. |
cSpell.showCommandsInEditorContextMenu |
application | Show Spell Checker actions in Editor Context Menu |
cSpell.showStatus |
application | Display the spell checker status on the status bar. |
cSpell.showStatusAlignment |
application | The side of the status bar to display the spell checker status. |
cSpell.showSuggestionsLinkInEditorContextMenu |
application | Show Spelling Suggestions link in the top level context menu. |
cSpell.suggestionMenuType |
resource | The type of menu used to display spelling suggestions. |
cSpell.suggestionNumChanges |
resource | The maximum number of changes allowed on a word to be considered a suggestions. |
cSpell.validateDirectives |
window | Verify that the in-document directives are correct. |
Name
: cSpell.autoFormatConfigFile
-- Auto Format Configuration File
Type : boolean
Scope : window
Description
: If a cspell
configuration file is updated, format the configuration file
using the VS Code Format Document Provider. This will cause the configuration
file to be saved prior to being updated.
Default
: false
Name
: cSpell.diagnosticLevel
-- Set Diagnostic Reporting Level
Type
: ( "Error"
| "Warning"
| "Information"
| "Hint"
)
| `Error` | Report Spelling Issues as Errors |
| `Warning` | Report Spelling Issues as Warnings |
| `Information` | Report Spelling Issues as Information |
| `Hint` | Report Spelling Issues as Hints, will not show up in Problems |
Scope : resource
Description
: The Diagnostic Severity Level determines how issues are shown in the Problems Pane and within the document.
Set the level to Hint
to hide the issues from the Problems Pane. Use the #cSpell.decorateIssues#
to control how issues are displayed in the document.
Default
: "Hint"
Name
: cSpell.diagnosticLevelFlaggedWords
-- Set Diagnostic Reporting Level for Flagged Words
Type
: ( "Error"
| "Warning"
| "Information"
| "Hint"
)
| `Error` | Report Spelling Issues as Errors |
| `Warning` | Report Spelling Issues as Warnings |
| `Information` | Report Spelling Issues as Information |
| `Hint` | Report Spelling Issues as Hints, will not show up in Problems |
Scope : resource
Description : Flagged word issues found by the spell checker are marked with a Diagnostic Severity Level. This affects the color of the squiggle. By default, flagged words will use the same diagnostic level as general issues. Use this setting to customize them.
Default : - none -
Version : 4.0.0
Name
: cSpell.diagnosticLevelSCM
-- Set Diagnostic Reporting Level in SCM Commit Message
Type
: ( "Error"
| "Warning"
| "Information"
| "Hint"
| "Off"
)
| `Error` | Report Spelling Issues as Errors |
| `Warning` | Report Spelling Issues as Warnings |
| `Information` | Report Spelling Issues as Information |
| `Hint` | Report Spelling Issues as Hints, will not show up in Problems |
| `Off` | Do not Report Spelling Issues |
Scope : resource
Description : Diagnostic level for source control commit messages. Issues found by the spell checker are marked with a Diagnostic Severity Level. This affects the color of the squiggle.
By default, this setting will match `#cSpell.diagnosticLevel#`.
Default : - none -
Name
: cSpell.hideAddToDictionaryCodeActions
Type : boolean
Scope : resource
Description : Hide the options to add words to dictionaries or settings.
Default
: false
Name
: cSpell.maxDuplicateProblems
Type : number
Scope : resource
Description : The maximum number of times the same word can be flagged as an error in a file.
Default
: 20
Name
: cSpell.maxNumberOfProblems
Type : number
Scope : resource
Description : Controls the maximum number of spelling errors per document.
Default
: 100
Name
: cSpell.minWordLength
Type : number
Scope : resource
Description : The minimum length of a word before checking it against a dictionary.
Default
: 4
Name
: cSpell.numSuggestions
Type : number
Scope : resource
Description : Controls the number of suggestions shown.
Default
: 8
Name
: cSpell.showAutocompleteDirectiveSuggestions
Type : boolean
Scope : language-overridable
Description : Show CSpell in-document directives as you type.
**Note:** VS Code must be restarted for this setting to take effect.
Default
: true
Name
: cSpell.showCommandsInEditorContextMenu
Type : boolean
Scope : application
Description : Show Spell Checker actions in Editor Context Menu
Default
: true
Name
: cSpell.showStatus
Type : boolean
Scope : application
Description : Display the spell checker status on the status bar.
Default
: true
Name
: cSpell.showStatusAlignment
Type
: ( "Left"
| "Right"
)
| `Left` | Left Side of Statusbar |
| `Right` | Right Side of Statusbar |
Scope : application
Description : The side of the status bar to display the spell checker status.
Default
: "Right"
Name
: cSpell.showSuggestionsLinkInEditorContextMenu
Type : boolean
Scope : application
Description : Show Spelling Suggestions link in the top level context menu.
Default
: true
Name
: cSpell.suggestionMenuType
Type
: ( "quickPick"
| "quickFix"
)
| `quickPick` | Suggestions will appear as a drop down at the top of the IDE. (Best choice for Vim Key Bindings) |
| `quickFix` | Suggestions will appear inline near the word, inside the text editor. |
Scope : resource
Description : The type of menu used to display spelling suggestions.
Default
: "quickPick"
Name
: cSpell.suggestionNumChanges
Type : number
Scope : resource
Description : The maximum number of changes allowed on a word to be considered a suggestions.
For example, appending an `s` onto `example` -> `examples` is considered 1 change.
Range: between 1 and 5.
Default
: 3
Name
: cSpell.validateDirectives
Type : boolean
Scope : window
Description : Verify that the in-document directives are correct.
Default : - none -
Setting | Scope | Description |
---|---|---|
cSpell.allowedSchemas |
window | Define Allowed Schemas |
cSpell.checkOnlyEnabledFileTypes |
resource | Check Only Enabled File Types |
cSpell.enableFiletypes |
resource | File Types to Check |
cSpell.files |
resource | Glob patterns of files to be checked. Glob patterns are relative to the #cSpell.globRoot# … |
cSpell.globRoot |
resource | The root to use for glob patterns found in this configuration. Default: The current workspace… |
cSpell.ignorePaths |
resource | Glob patterns of files to be ignored |
cSpell.import |
resource | Allows this configuration to inherit configuration for one or more other files. |
cSpell.mergeCSpellSettings |
resource | Specify if fields from .vscode/settings.json are passed to the spell checker. This only applies… |
cSpell.mergeCSpellSettingsFields |
resource | Specify which fields from .vscode/settings.json are passed to the spell checker. This only… |
cSpell.noConfigSearch |
resource | Prevents searching for local configuration when checking individual documents. |
cSpell.spellCheckOnlyWorkspaceFiles |
window | Spell Check Only Workspace Files |
cSpell.useGitignore |
resource | Tells the spell checker to load .gitignore files and skip files that match the globs in the… |
cSpell.usePnP |
resource | Packages managers like Yarn 2 use a .pnp.cjs file to assist in loading packages stored in… |
cSpell.workspaceRootPath |
resource | Workspace Root Folder Path |
Name
: cSpell.allowedSchemas
-- Define Allowed Schemas
Type : string[]
Scope : window
Description : Control which file schemas will be checked for spelling (VS Code must be restarted for this setting to take effect).
Some schemas have special meaning like:
- `untitled` - Used for new documents that have not yet been saved
- `vscode-notebook-cell` - Used for validating segments of a Notebook.
- `vscode-userdata` - Needed to spell check `.code-snippets`
- `vscode-scm` - Needed to spell check Source Control commit messages.
Default
: [ "file"
, "gist"
, "repo"
, "sftp"
, "untitled"
, "vscode-notebook-cell"
, "vscode-scm"
, "vscode-userdata"
, "vscode-vfs"
, "vsls"
]
Name
: cSpell.checkOnlyEnabledFileTypes
-- Check Only Enabled File Types
Type : boolean
Scope : resource
Description
: By default, the spell checker checks only enabled file types. Use #cSpell.enableFiletypes#
to turn on / off various file types.
When this setting is `false`, all file types are checked except for the ones disabled by `#cSpell.enableFiletypes#`.
See `#cSpell.enableFiletypes#` on how to disable a file type.
Default
: true
Name
: cSpell.enableFiletypes
-- File Types to Check
Type : string[]
Scope : resource
Description : Enable / Disable checking file types (languageIds).
These are in additional to the file types specified by `#cSpell.enabledLanguageIds#`.
To disable a language, prefix with `!` as in `!json`,
**Example: individual file types**
```
jsonc // enable checking for jsonc
!json // disable checking for json
kotlin // enable checking for kotlin
```
**Example: enable all file types**
```
* // enable checking for all file types
!json // except for json
```
Default : - none -
Name
: cSpell.files
Type : string[]
Scope : resource
Description
: Glob patterns of files to be checked.
Glob patterns are relative to the #cSpell.globRoot#
of the configuration file that defines them.
Default : - none -
Name
: cSpell.globRoot
Type : string
Scope : resource
Description
: The root to use for glob patterns found in this configuration.
Default: The current workspace folder.
Use globRoot
to define a different location. globRoot
can be relative to the location of this configuration file.
Defining globRoot, does not impact imported configurations.
Special Values:
- `${workspaceFolder}` - Default - globs will be relative to the current workspace folder
- `${workspaceFolder:<name>}` - Where `<name>` is the name of the workspace folder.
Default : - none -
Name
: cSpell.ignorePaths
-- Glob patterns of files to be ignored
Type : string[]
Scope : resource
Description
: Glob patterns of files to be ignored. The patterns are relative to the #cSpell.globRoot#
of the configuration file that defines them.
Default
: [ "package-lock.json"
, "node_modules"
, "vscode-extension"
, ".git/objects"
, ".vscode"
, ".vscode-insiders"
]
Name
: cSpell.import
Type : string[]
Scope : resource
Description : Allows this configuration to inherit configuration for one or more other files.
See [Importing / Extending Configuration](https://cspell.org/configuration/imports/) for more details.
Default : - none -
Name
: cSpell.mergeCSpellSettings
Type : boolean
Scope : resource
Description
: Specify if fields from .vscode/settings.json
are passed to the spell checker.
This only applies when there is a CSpell configuration file in the workspace.
The purpose of this setting to help provide a consistent result compared to the
CSpell spell checker command line tool.
Values:
- `true` - all settings will be merged based upon `#cSpell.mergeCSpellSettingsFields#`.
- `false` - only use `.vscode/settings.json` if a CSpell configuration is not found.
Note: this setting is used in conjunction with `#cSpell.mergeCSpellSettingsFields#`.
Default
: true
Version : 4.0.0
Name
: cSpell.mergeCSpellSettingsFields
Type : object
Scope : resource
Description
: Specify which fields from .vscode/settings.json
are passed to the spell checker.
This only applies when there is a CSpell configuration file in the workspace and
#cSpell.mergeCSpellSettings#
is true
.
Values:
- `{ flagWords: true, userWords: false }` - Always allow `flagWords`, but never allow `userWords`.
Example:
```jsonc
"cSpell.mergeCSpellSettingsFields": { "userWords": false }
```
Default
: {"allowCompoundWords":true,"caseSensitive":true,"dictionaries":true,"dictionaryDefinitions":true,"enableGlobDot":true,"features":true,"files":true,"flagWords":true,"gitignoreRoot":true,"globRoot":true,"ignorePaths":true,"ignoreRegExpList":true,"ignoreWords":true,"import":true,"includeRegExpList":true,"language":true,"languageId":true,"languageSettings":true,"loadDefaultConfiguration":true,"minWordLength":true,"noConfigSearch":true,"noSuggestDictionaries":true,"numSuggestions":true,"overrides":true,"patterns":true,"pnpFiles":true,"reporters":true,"suggestWords":true,"useGitignore":true,"usePnP":true,"userWords":true,"validateDirectives":true,"words":true}
Version : 4.0.0
Name
: cSpell.noConfigSearch
Type : boolean
Scope : resource
Description : Prevents searching for local configuration when checking individual documents.
Default : - none -
Name
: cSpell.spellCheckOnlyWorkspaceFiles
-- Spell Check Only Workspace Files
Type : boolean
Scope : window
Description
: Only spell check files that are in the currently open workspace.
This same effect can be achieved using the #cSpell.files#
setting.
```js
"cSpell.files": ["/**"]
```
Default
: false
Name
: cSpell.useGitignore
Type : boolean
Scope : resource
Description
: Tells the spell checker to load .gitignore
files and skip files that match the globs in the .gitignore
files found.
Default
: true
Name
: cSpell.usePnP
Type : boolean
Scope : resource
Description
: Packages managers like Yarn 2 use a .pnp.cjs
file to assist in loading
packages stored in the repository.
When true, the spell checker will search up the directory structure for the existence
of a PnP file and load it.
Default : - none -
Name
: cSpell.workspaceRootPath
-- Workspace Root Folder Path
Type : string
Scope : resource
Description : Define the path to the workspace root folder in a multi-root workspace. By default it is the first folder.
This is used to find the `cspell.json` file for the workspace.
**Example: use the `client` folder**
```
${workspaceFolder:client}
```
Default : - none -
Setting | Scope | Description |
---|---|---|
cSpell.blockCheckingWhenAverageChunkSizeGreaterThan |
language-overridable | The maximum average length of chunks of text without word breaks. |
cSpell.blockCheckingWhenLineLengthGreaterThan |
language-overridable | The maximum line length. |
cSpell.blockCheckingWhenTextChunkSizeGreaterThan |
language-overridable | The maximum length of a chunk of text without word breaks. |
cSpell.checkLimit |
resource | Set the maximum number of bocks of text to check. Each block is 1024 characters. |
cSpell.spellCheckDelayMs |
application | Delay in ms after a document has changed before checking it for spelling errors. |
cSpell.suggestionsTimeout |
resource | The maximum amount of time in milliseconds to generate suggestions for a word. |
Name
: cSpell.blockCheckingWhenAverageChunkSizeGreaterThan
Type : number
Scope : language-overridable
Description : The maximum average length of chunks of text without word breaks.
A chunk is the characters between absolute word breaks.
Absolute word breaks match: `/[\s,{}[\]]/`
**Error Message:** _Average Word Size is Too High._
If you are seeing this message, it means that the file contains mostly long lines
without many word breaks.
Default
: 80
Name
: cSpell.blockCheckingWhenLineLengthGreaterThan
Type : number
Scope : language-overridable
Description : The maximum line length.
Block spell checking if lines are longer than the value given.
This is used to prevent spell checking generated files.
**Error Message:** _Lines are too long._
Default
: 10000
Name
: cSpell.blockCheckingWhenTextChunkSizeGreaterThan
Type : number
Scope : language-overridable
Description : The maximum length of a chunk of text without word breaks.
It is used to prevent spell checking of generated files.
A chunk is the characters between absolute word breaks.
Absolute word breaks match: `/[\s,{}[\]]/`, i.e. spaces or braces.
**Error Message:** _Maximum Word Length is Too High._
If you are seeing this message, it means that the file contains a very long line
without many word breaks.
Default
: 500
Name
: cSpell.checkLimit
Type : number
Scope : resource
Description : Set the maximum number of bocks of text to check. Each block is 1024 characters.
Default
: 500
Name
: cSpell.spellCheckDelayMs
Type : number
Scope : application
Description : Delay in ms after a document has changed before checking it for spelling errors.
Default
: 50
Name
: cSpell.suggestionsTimeout
Type : number
Scope : resource
Description : The maximum amount of time in milliseconds to generate suggestions for a word.
Default
: 400
Setting | Scope | Description |
---|---|---|
cSpell.ignoreRegExpList |
resource | List of regular expressions or Pattern names (defined in #cSpell.patterns# ) to exclude from… |
cSpell.includeRegExpList |
resource | List of regular expression patterns or defined pattern names to match for spell checking. |
cSpell.overrides |
resource | Overrides are used to apply settings for specific files in your project. |
cSpell.patterns |
resource | Defines a list of patterns that can be used with the #cSpell.ignoreRegExpList# and #cSpell.includeRegExpList# … |
cSpell.useLocallyInstalledCSpellDictionaries |
resource | Search for @cspell/cspell-bundled-dicts in the workspace folder and use it if found. |
Name
: cSpell.ignoreRegExpList
Type : string[]
Scope : resource
Description
: List of regular expressions or Pattern names (defined in #cSpell.patterns#
) to exclude from spell checking.
- When using the VS Code Preferences UI, it is not necessary to escape the `\`, VS Code takes care of that.
- When editing the VS Code `settings.json` file,
it is necessary to escape `\`.
Each `\` becomes `\\`.
The default regular expression flags are `gi`. Add `u` (`gui`), to enable Unicode.
| VS Code UI | settings.json | Description |
| :------------------ | :-------------------- | :------------------------------------------- |
| `/\\[a-z]+/gi` | `/\\\\[a-z]+/gi` | Exclude LaTeX command like `\mapsto` |
| `/\b[A-Z]{3,5}\b/g` | `/\\b[A-Z]{3,5}\\b/g` | Exclude full-caps acronyms of 3-5 length. |
| `CStyleComment` | `CStyleComment` | A built in pattern |
Default : - none -
Name
: cSpell.includeRegExpList
Type : string[]
Scope : resource
Description : List of regular expression patterns or defined pattern names to match for spell checking.
If this property is defined, only text matching the included patterns will be checked.
Default : - none -
Name
: cSpell.overrides
Type : object[]
Scope : resource
Description : Overrides are used to apply settings for specific files in your project.
**Example:**
```jsonc
"cSpell.overrides": [
// Force `*.hrr` and `*.crr` files to be treated as `cpp` files:
{
"filename": "**/{*.hrr,*.crr}",
"languageId": "cpp"
},
// Force `dutch/**/*.txt` to be treated as Dutch (dictionary needs to be installed separately):
{
"filename": "**/dutch/**/*.txt",
"language": "nl"
}
]
```
Default : - none -
Name
: cSpell.patterns
Type : object[]
Scope : resource
Description
: Defines a list of patterns that can be used with the #cSpell.ignoreRegExpList#
and
#cSpell.includeRegExpList#
options.
**Example:**
```jsonc
"cSpell.patterns": [
{
"name": "comment-single-line",
"pattern": "/#.*/g"
},
{
"name": "comment-multi-line",
"pattern": "/(?:\\/\\*[\\s\\S]*?\\*\\/)/g"
}
]
```
Default : - none -
Name
: cSpell.useLocallyInstalledCSpellDictionaries
Type : boolean
Scope : resource
Description
: Search for @cspell/cspell-bundled-dicts
in the workspace folder and use it if found.
Default
: true
Version : 4.0.0
Setting | Scope | Description |
---|---|---|
cSpell.dark |
application | Decoration for dark themes. |
cSpell.decorateIssues |
application | Draw custom decorations on Spelling Issues when the #cSpell.diagnosticLevel# is Hint . |
cSpell.light |
application | Decoration for light themes. |
cSpell.overviewRulerColor |
application | The CSS color used to show issues in the ruler. |
cSpell.textDecoration |
application | The CSS Style used to decorate spelling issues. Depends upon #cSpell.decorateIssues# . |
cSpell.textDecorationColor |
application | The decoration color for normal spelling issues. |
cSpell.textDecorationColorFlagged |
application | The decoration color for flagged issues. |
cSpell.textDecorationLine |
application | The CSS line type used to decorate issues. |
cSpell.textDecorationStyle |
application | The CSS line style used to decorate issues. |
cSpell.textDecorationThickness |
application | The CSS line thickness used to decorate issues. |
Name
: cSpell.dark
Type : object
Scope : application
Description : Decoration for dark themes.
See:
- `#cSpell.overviewRulerColor#`
- `#cSpell.textDecoration#`
Default : - none -
Name
: cSpell.decorateIssues
Type : boolean
Scope : application
Description
: Draw custom decorations on Spelling Issues when the #cSpell.diagnosticLevel#
is Hint
.
Default
: true
Version : 4.0.0
Name
: cSpell.light
Type : object
Scope : application
Description : Decoration for light themes.
See:
- `#cSpell.overviewRulerColor#`
- `#cSpell.textDecoration#`
Default : - none -
Name
: cSpell.overviewRulerColor
Type : string
Scope : application
Description : The CSS color used to show issues in the ruler.
See:
- [`<color>` CSS: Cascading Style Sheets, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value)
- [CSS Colors, W3C Schools](https://www.w3schools.com/cssref/css_colors.php)
- Hex colors
- Use "" (empty string) to disable.
Examples:
- `green`
- `DarkYellow`
- `#ffff0080` - semi-transparent yellow.
- `rgb(255 153 0 / 80%)`
Default
: "#fc4c"
Version : 4.0.0
Name
: cSpell.textDecoration
Type : string
Scope : application
Description
: The CSS Style used to decorate spelling issues. Depends upon #cSpell.decorateIssues#
.
This setting is used to manually configure the text decoration. If it is not set, the following settings are used:
- `#cSpell.textDecorationLine#` to pick the line type
- `#cSpell.textDecorationStyle#` to pick the style
- `#cSpell.textDecorationColor#` to set the color
- `#cSpell.textDecorationThickness#` to set the thickness.
See: [text-decoration - CSS: Cascading Style Sheets, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
Format: `<line> [style] <color> [thickness]`
- line - `underline`, `overline`, see: [text-decoration-line, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-line)
- style - `solid`, `wavy`, `dotted`, see: [text-decoration-style, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-style)
- color - see: [text-decoration-color, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-color)
- thickness - see: [text-decoration-thickness, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-thickness)
Examples:
- `underline green`
- `underline dotted yellow 0.2rem`
- `underline wavy #ff0c 1.5px` - Wavy underline with 1.5px thickness in semi-transparent yellow.
Default : - none -
Version : 4.0.0
Name
: cSpell.textDecorationColor
Type : string
Scope : application
Description : The decoration color for normal spelling issues.
See: [text-decoration - CSS: Cascading Style Sheets, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
- color - see: [text-decoration-color, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-color)
Examples:
- `green`
- `yellow`
- `#ff0c`
Default
: "#fc4"
Version : 4.0.0
Name
: cSpell.textDecorationColorFlagged
Type : string
Scope : application
Description : The decoration color for flagged issues.
See: [text-decoration - CSS: Cascading Style Sheets, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
- color - see: [text-decoration-color, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-color)
Examples:
- `green`
- `yellow`
- `#ff0c`
Default
: "#f44"
Version : 4.0.0
Name
: cSpell.textDecorationLine
Type
: ( "underline"
| "overline"
| "line-through"
)
Scope : application
Description : The CSS line type used to decorate issues.
See: [text-decoration - CSS: Cascading Style Sheets, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
- line - `underline`, `overline`, see: [text-decoration-line, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-line)
Default
: "underline"
Version : 4.0.0
Name
: cSpell.textDecorationStyle
Type
: ( "solid"
| "wavy"
| "dotted"
| "dashed"
| "double"
)
Scope : application
Description : The CSS line style used to decorate issues.
See: [text-decoration - CSS: Cascading Style Sheets, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
- style - `solid`, `wavy`, `dotted`, see: [text-decoration-style, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-style)
Default
: "wavy"
Version : 4.0.0
Name
: cSpell.textDecorationThickness
Type : string
Scope : application
Description : The CSS line thickness used to decorate issues.
See: [text-decoration - CSS: Cascading Style Sheets, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration)
- thickness - see: [text-decoration-thickness, MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-decoration-thickness)
Examples:
- `auto`
- `from-font`
- `0.2rem`
- `1.5px`
- `10%`
Default
: "auto"
Version : 4.0.0
Setting | Scope | Description |
---|---|---|
cSpell.advanced.feature.useReferenceProviderRemove |
language-overridable | Remove Matching Characters Before Rename |
cSpell.advanced.feature.useReferenceProviderWithRename |
language-overridable | Use Reference Provider During Rename |
cSpell.fixSpellingWithRenameProvider |
language-overridable | Use Rename Provider when fixing spelling issues. |
cSpell.logFile |
window | Write Logs to a File |
cSpell.logLevel |
window | Set Logging Level |
cSpell.trustedWorkspace |
window | Enable loading JavaScript CSpell configuration files. |
Name
: cSpell.advanced.feature.useReferenceProviderRemove
-- Remove Matching Characters Before Rename
Type : string
Scope : language-overridable
Description : Used to work around bugs in Reference Providers and Rename Providers. Anything matching the provided Regular Expression will be removed from the text before sending it to the Rename Provider.
See: [Markdown: Fixing spelling issues in Header sections changes the entire line · Issue #1987](https://github.com/streetsidesoftware/vscode-spell-checker/issues/1987)
It is unlikely that you would need to edit this setting. If you need to, please open an issue at
[Spell Checker Issues](https://github.com/streetsidesoftware/vscode-spell-checker/issues)
This feature is used in connection with `#cSpell.advanced.feature.useReferenceProviderWithRename#`
Default : - none -
Name
: cSpell.advanced.feature.useReferenceProviderWithRename
-- Use Reference Provider During Rename
Type : boolean
Scope : language-overridable
Description
: Use the Reference Provider when fixing spelling issues with the Rename Provider.
This feature is used in connection with #cSpell.fixSpellingWithRenameProvider#
Default
: false
Name
: cSpell.fixSpellingWithRenameProvider
Type : boolean
Scope : language-overridable
Description : Use Rename Provider when fixing spelling issues.
Default
: true
Name
: cSpell.logFile
-- Write Logs to a File
Type : string
Scope : window
Description : Have the logs written to a file instead of to VS Code.
Default : - none -
Name
: cSpell.logLevel
-- Set Logging Level
Type
: ( "None"
| "Error"
| "Warning"
| "Information"
| "Debug"
)
| `None` | Do not log |
| `Error` | Log only errors |
| `Warning` | Log errors and warnings |
| `Information` | Log errors, warnings, and info |
| `Debug` | Log everything (noisy) |
Scope : window
Description : Set the Debug Level for logging messages.
Default
: "Error"
Name
: cSpell.trustedWorkspace
Type : boolean
Scope : window
Description : Enable loading JavaScript CSpell configuration files.
This setting is automatically set to `true` in a trusted workspace. It is possible to override the setting to `false` in a trusted workspace,
but a setting of `true` in an untrusted workspace will be ignored.
See:
- [Visual Studio Code Workspace Trust security](https://code.visualstudio.com/docs/editor/workspace-trust)
- [Workspace Trust Extension Guide -- Visual Studio Code Extension API](https://code.visualstudio.com/api/extension-guides/workspace-trust)
Default
: true
Version : 4.0.0
Setting | Scope | Description |
---|---|---|
cSpell.experimental.enableRegexpView |
application | Show Regular Expression Explorer |
cSpell.experimental.enableSettingsViewerV2 |
application | Enable the Settings Viewer V2 Extension |
Name
: cSpell.experimental.enableRegexpView
Type : boolean
Scope : application
Description : Show Regular Expression Explorer
Default
: false
Name
: cSpell.experimental.enableSettingsViewerV2
Type : boolean
Scope : application
Description : Enable the Settings Viewer V2 Extension
Default
: false
Setting | Scope | Description |
---|---|---|
cSpell.allowCompoundWords |
resource | Enable / Disable allowing word compounds. |
cSpell.enabledLanguageIds |
resource | Enabled Language Ids |
Name
: cSpell.allowCompoundWords
Type : boolean
Scope : resource
Description
: Enable / Disable allowing word compounds. - true
means arraylength
would be ok - false
means it would not pass.
Note: this can also cause many misspelled words to seem correct.
Default
: false
Name
: -- Custom Folder DictionariescSpell.customFolderDictionaries
Type : []
Scope : resource
Description
: Define custom dictionaries to be included by default for the folder.
If addWords
is true
words will be added to this dictionary.
Deprecation Message
: - Use #cSpell.customDictionaries#
instead.
Default : - none -
Name
: -- Custom User DictionariescSpell.customUserDictionaries
Type : []
Scope : application
Description
: Define custom dictionaries to be included by default for the user.
If addWords
is true
words will be added to this dictionary.
Deprecation Message
: - Use #cSpell.customDictionaries#
instead.
Default : - none -
Name
: -- Custom Workspace DictionariescSpell.customWorkspaceDictionaries
Type : []
Scope : resource
Description
: Define custom dictionaries to be included by default for the workspace.
If addWords
is true
words will be added to this dictionary.
Deprecation Message
: - Use #cSpell.customDictionaries#
instead.
Default : - none -
Name
: cSpell.enabledLanguageIds
-- Enabled Language Ids
Type : string[]
Scope : resource
Description
: Specify a list of file types to spell check. It is better to use #cSpell.enableFiletypes#
to Enable / Disable checking files types.
Default
: [ "asciidoc"
, "bat"
, "c"
, "clojure"
, "coffeescript"
, "cpp"
, "csharp"
, "css"
, "dart"
, "diff"
, "dockerfile"
, "elixir"
, "erlang"
, "fsharp"
, "git-commit"
, "git-rebase"
, "github-actions-workflow"
, "go"
, "graphql"
, "groovy"
, "handlebars"
, "haskell"
, "html"
, "ini"
, "jade"
, "java"
, "javascript"
, "javascriptreact"
, "json"
, "jsonc"
, "julia"
, "jupyter"
, "latex"
, "less"
, "lua"
, "makefile"
, "markdown"
, "objective-c"
, "perl"
, "perl6"
, "php"
, "plaintext"
, "powershell"
, "properties"
, "pug"
, "python"
, "r"
, "razor"
, "restructuredtext"
, "ruby"
, "rust"
, "scala"
, "scminput"
, "scss"
, "shaderlab"
, "shellscript"
, "sql"
, "swift"
, "text"
, "typescript"
, "typescriptreact"
, "vb"
, "vue"
, "xml"
, "xsl"
, "yaml"
]