Vim Tips Wiki
No edit summary
No edit summary
Line 1: Line 1:
If Vim is misbehaving there are some steps that you can follow:
 
 
=Generic troubleshooting=
 
=Generic troubleshooting=
  +
Sometimes a basic feature of Vim does not work as expected, the following instructions can help to find out where the problem is located.
  +
 
==Discard Vim executable==
 
==Discard Vim executable==
 
Run <tt>vim -N -u NONE</tt> and see if the problem persists.
 
Run <tt>vim -N -u NONE</tt> and see if the problem persists.

Revision as of 21:24, 8 September 2011

Generic troubleshooting

Sometimes a basic feature of Vim does not work as expected, the following instructions can help to find out where the problem is located.

Discard Vim executable

Run vim -N -u NONE and see if the problem persists.

Verify enabled features

Check the feature you need was enabled when Vim was built. Use the :version command to see if said feature is enabled.

  • Some/any needed features are disabled. Build Vim with desired feature enabled or use your package manager to install it.
  • All needed features are enabled. What to do here?

Discard vimrc

Run vim -N --noplugin and see if the problem persists.

  • The problem persists. The reason of your pain is your vimrc.
  • The problem went away. The next step is to discard the plugins.

Discard plugins

Run vim -N -u NORC and see if the problem persists.

  • The problem persists. It looks like the issue is related to a plugin.
  • The problem went away. Maybe the problem is that Vim is running in compatible mode, verify that with :verbose set cp? to also see where it's being set.

Specific troubleshooting

Plugins

VIMRC

Mappings

Options