jetbrains-doc-sync

IdeaVim

[![Official JetBrains Project][jb-official-svg]][jb-official] [![Contributions welcome][contributions-welcome-svg]][contributions-welcome] [![Downloads][plugin-downloads-svg]][plugin-repo] [![Rating][plugin-rating-svg]][plugin-repo] [![Version][plugin-version-svg]][plugin-repo] [![Gitter][gitter-svg]][gitter] [![Twitter][twitter-svg]][twitter]

IdeaVim is a Vim engine for JetBrains IDEs.

Contact maintainers:

• Bug tracker
• @IdeaVim on Twitter
• Chat on gitter
• IdeaVim Channel on JetBrains Server

Resources:

• Plugin homepage
• Plugin on Marketplace
• Changelog
• Continuous integration builds

Compatibility

IntelliJ IDEA, PyCharm, GoLand, CLion, PhpStorm, WebStorm, RubyMine, DataGrip, DataSpell, Rider, Cursive, Android Studio, and other JetBrains IDEs.

Setup

• IdeaVim can be installed via Settings | Plugins. See the detailed instructions.

• Use Tools | Vim in the menu to enable or disable vim.

• Use the ~/.ideavimrc file as an analog of ~/.vimrc (learn more). The XDG standard is supported, as well.

• Shortcut conflicts can be resolved by using:

  • On Linux & Windows: File | Settings | Editor | Vim & File | Settings | Keymap,
  • On macOS: Preferences | Editor | Vim & Preferences | Keymap,
  • Regular Vim mappings in the ~/.ideavimrc file.

Get Early Access

Would you like to try new features and fixes? Join the Early Access Program and receive EAP builds as updates!

1. Click the IdeaVim icon in the status bar | Early Access Program | Subscribe to EAP

Or subscribe to EAP updates manually:

1. Open Settings | Plugins
2. Click the gear icon :gear:, select Manage Plugin Repositories, and add the following url:

https://plugins.jetbrains.com/plugins/eap/ideavim

See the changelog for the list of unreleased features.

It is important to distinguish EAP builds from traditional pre-release software. Please note that the quality of EAP versions may at times be way below even usual beta standards.

You can always leave your feedback with:

• @IdeaVim in Twitter
• Bug tracker

Summary of Supported Vim Features

Here are some examples of supported vim features and commands:

• Normal / insert / visual / select / etc. modes
• Motion / deletion / change / window / etc. commands
• Key mappings
• Marks / Macros / Digraphs / Registers
• Some set commands
• Full Vim regexps for search and search/replace
• Vim web help
• ~/.ideavimrc configuration file
• Vim script, including some builtin functions
• IdeaVim plugins

See also:

• Top feature requests and bugs

Files

• ~/.ideavimrc
  • Your IdeaVim-specific Vim initialization commands

""" Map leader to space ---------------------
let mapleader=" "

""" Plugins  --------------------------------
set surround
set multiple-cursors
set commentary
set argtextobj
set easymotion
set textobj-entire
set ReplaceWithRegister

""" Plugin settings -------------------------
let g:argtextobj_pairs="[:],(:),<:>"

""" Common settings -------------------------
set showmode
set so=5
set incsearch
set nu

""" Idea specific settings ------------------
set ideajoin
set ideastatusicon=gray
set idearefactormode=keep

""" Mappings --------------------------------
map <leader>f <Plug>(easymotion-s)
map <leader>e <Plug>(easymotion-f)

map <leader>d <Action>(Debug)
map <leader>r <Action>(RenameElement)
map <leader>c <Action>(Stop)
map <leader>z <Action>(ToggleDistractionFreeMode)

map <leader>s <Action>(SelectInProjectView)
map <leader>a <Action>(Annotate)
map <leader>h <Action>(Vcs.ShowTabbedFileHistory)
map <S-Space> <Action>(GotoNextError)

map <leader>b <Action>(ToggleLineBreakpoint)
map <leader>o <Action>(FileStructurePopup)