github.com/VSCodeVim/Vim @v1.32.4 sqlite

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
  • "vim.insertModeKeyBindings"/"vim.normalModeKeyBindings"/"vim.visualModeKeyBindings"/"vim.operatorPendingModeKeyBindings"
  • "vim.insertModeKeyBindingsNonRecursive"/"normalModeKeyBindingsNonRecursive"/"visualModeKeyBindingsNonRecursive"/"operatorPendingModeKeyBindingsNonRecursive"
  • 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:

defaults write com.microsoft.VSCode ApplePressAndHoldEnabled -bool false              # For VS Code
defaults write com.microsoft.VSCodeInsiders ApplePressAndHoldEnabled -bool false      # For VS Code Insider
defaults write com.vscodium ApplePressAndHoldEnabled -bool false                      # For VS Codium
defaults write com.microsoft.VSCodeExploration ApplePressAndHoldEnabled -bool false   # For VS Codium Exploration users
defaults write com.exafunction.windsurf ApplePressAndHoldEnabled -bool false          # For Windsurf
defaults delete -g ApplePressAndHoldEnabled                                           # If necessary, reset global default

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 useCtrlKeys and handleKeys settings.

⚙️ Settings

The settings documented here are a subset of the supported settings; the full list is described in the FEATURES -> Settings 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:

{
  "vim.easymotion": true,
  "vim.incsearch": true,
  "vim.useSystemClipboard": true,
  "vim.useCtrlKeys": true,
  "vim.hlsearch": true,
  "vim.insertModeKeyBindings": [
    {
      "before": ["j", "j"],
      "after": ["<Esc>"]
    }
  ],
  "vim.normalModeKeyBindingsNonRecursive": [
    {
      "before": ["<leader>", "d"],
      "after": ["d", "d"]
    },
    {
      "before": ["<C-n>"],
      "commands": [":nohl"]
    },
    {
      "before": ["K"],
      "commands": ["lineBreakInsert"],
      "silent": true
    }
  ],
  "vim.leader": "<space>",
  "vim.handleKeys": {
    "<C-a>": false,
    "<C-f>": false
  },
  // To improve performance
  "extensions.experimental.affinity": {
    "vscodevim.vim": 1
  }
}

VSCodeVim settings

These settings are specific to VSCodeVim.

"<C-s>": false

"<C-z>": false | | 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 | findMatchHighlightBackground ThemeColor | | vim.searchHighlightTextColor | Foreground color of non-current search matches | String | None | | vim.searchMatchColor | Background color of current search match | String | findMatchBackground ThemeColor | | vim.searchMatchTextColor | Foreground color of current search match | String | None | | vim.substitutionColor | Background color of substitution text when vim.inccommand is enabled | String | "#50f01080" | | vim.substitutionTextColor | Foreground color of substitution text when vim.inccommand is enabled | String | None | | vim.startInInsertMode | Start in Insert mode instead of Normal Mode | Boolean | false | | vim.us