VSCodeVim / Vim

VSCodeVim Vim emulation for Visual Studio Code VSCodeVim is a Vim emulator for Visual Studio Code. • 📃 Our change log outlines the breaking/major/minor updates between releases. • Report missing features/bugs on GitHub. Table of Contents (click to expand) • 💾 Installation • Mac • Windows • ⚙️ Settings • Quick Example • VSCodeVim settings • Neovim Integration • Key Remapping • / / / • / / / • Debugging Remappings • Remapping more complex key combinations • Vim modes • Vim settings • .vimrc support • 🖱️ Multi-Cursor Mode • 🔌 Emulated Plugins • vim-airline • vim-easymotion • vim-surround • vim-commentary • vim-indent-object • vim-sneak • CamelCaseMotion • Input Method • ReplaceWithRegister • vim-textobj-entire • vim-textobj-arguments • 🎩 VSCodeVim tricks! • 📚 F.A.Q. • ❤️ Contributing • Special shoutouts to: 💾 Installation VSCodeVim can be installed via the VS Code Marketplace or the OpenVSX Marketplace. Mac To enable key-repeating, execute the following in your Terminal, log out and back in, and then restart VS Code: We also recommend increasing Key Repeat and Delay Until Repeat settings in _System Settings/Preferences -> Keyboard_. Windows Like real vim, VSCodeVim will take over your control keys. This behavior can be adjusted with the and settings. ⚙️ Settings The settings documented here are a subset of the supported settings; the full list is described in the -> tab of VSCodeVim's extension details page, which can be found in the extensions view of VS Code. Quick Example Below is an example of a settings.json file with settings relevant to VSCodeVim: VSCodeVim settings These settings are specific to VSCodeVim. | Setting | Description | Type | Default Value | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------- | | vim.changeWordIncludesWhitespace | Include trailing whitespace when changing word. This configures the cw action to act consistently as its siblings ( yw and dw ) instead of acting as ce . | Boolean | false | | vim.cursorStylePerMode._{Mode}_ | Configure a specific cursor style for _{Mode}_. Omitted modes will use default cursor type Supported cursors: line, block, underline, line-thin, block-outline, and underline-thin. | String | None | | vim.digraphs._{shorthand}_ | Set custom digraph shorthands that can override the default ones. Entries should map a two-character shorthand to a descriptive string and one or more UTF16 code points. Example: | Object | | | vim.disableExtension | Disable VSCodeVim extension. This setting can also be toggled using command in the Command Palette | Boolean | false | | vim.handleKeys | Delegate configured keys to be handled by VS Code instead of by the VSCodeVim extension. Any key in section of the package.json that has a in the argument can be delegated back to VS Code by setting . Example: to use for find (native VS Code behavior): . | String | | | vim.overrideCopy | Override VS Code's copy command with our own, which works correctly with VSCodeVim. If cmd-c/ctrl-c is giving you issues, set this to false and complain here. | Boolean | false | | vim.useSystemClipboard | Use the system clipboard register ( ) as the default register | Boolean | false | | vim.searchHighlightColor | Background color of non-current search matches | String | ThemeColor | | vim.searchHighlightTextColor | Foreground color of non-current search matches | String | None | | vim.searchMatchColor | Background color of current search match | String | ThemeColor | | vim.searchMatchTextColor | Foreground color of current search match | String | None | | vim.substitutionColor | Background color of substitution text when is enabled | String | "#50f01080" | | vim.substitutionTextColor | Foreground color of substitution text when is enabled | String | None | | vim.startInInsertMode | Start in Insert mode instead of Normal Mode | Boolean | false | | vim.useCtrlKeys | Enable Vim ctrl keys overriding common VS Code operations such as copy, paste, find, etc. | Boolean | true | | vim.visualstar | In visual mode, start a search with or using the current selection | Boolean | false | | vim.highlightedyank.enable | Enable highlighting when yanking | Boolean | false | | vim.highlightedyank.color | Set the color of yank highlights | String | rgba(250, 240, 170, 0.5) | | vim.highlightedyank.duration | Set the duration of yank highlights | Number | 200 | Neovim Integration > :warning: Experimental feature. Please leave feedback on neovim integration here. To leverage neovim for Ex-commands, • Install neovim • Modify the following configurations: | Setting | Description | Type | Default Value | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | ------------- | | vim.enableNeovim | Enable Neovim | Boolean | false | | vim.neovimPath | Full path to neovim executable. If left empty, PATH environment variable will be automatically checked for neovim path. | String | | | vim.neovimUseConfigFile | If , Neovim will load a config file specified by . This is necessary if you want Neovim to be able to use its own plugins. | Boolean | false | | vim.neovimConfigPath | Path that Neovim will load as config file. If left blank, Neovim will search in its default location. | String | | Here's some ideas on what you can do with neovim integration: • The power of g • The :normal command • Faster search and replace! Key Remapping Custom remappings are defined on a per-mode basi…