How do I exit Vim?

Asked 2023-09-20 20:01:37 View 890,905

I am stuck and cannot escape. It says:

type :quit<Enter> to quit VIM

But when I type that it simply appears in the object body.

  • Are you just trying to quit VIM ? If this is the case, press "escape" and then type ':q' - anyone
  • Don't forget the colon! You should type :quit and then hit the [ENTER] key. - anyone
  • It's really easy to learn the basics of vim, and it's built right into your system. In terminal type "vimtutor". 25 minutes later you will be going faster than your usual text editor! - anyone
  • Check here more commands. - anyone
  • To prevent git commit sending you to vim in the future: git config --global core.editor="nano" - anyone

Answers

Hit the Esc key to enter "Normal mode". Then you can type : to enter "Command-line mode". A colon (:) will appear at the bottom of the screen and you can type in one of the following commands. To execute a command, press the Enter key.

  • :q to quit (short for :quit)
  • :q! to quit without saving (short for :quit!)
  • :wq to write and quit
  • :wq! to write and quit, attempting to force the write if the file lacks write permission
  • :x to write and quit; like :wq but writes only if modified (short for :exit)
  • :qa to quit all (short for :quitall)
  • :cq to quit, without saving, with a nonzero exit code to indicate failure (short for :cquit)

You can also quit Vim directly from "Normal mode" by typing ZZ to save and quit (same as :x) or ZQ to just quit (same as :q!). (Note that case is important here. ZZ and zz do not mean the same thing.)

Vim has extensive help - that you can access with the :help command - where you can find answers to all your questions and a tutorial for beginners.

Answered   2023-09-20 20:01:37

  • Unless you have remapped esc or have a weird mapping in your .vimrc then it definitely should. If on linux type xev and make sure escape is the keytype you get when you hit escape. - anyone
  • Remember you can use ctrl+c if you can't use Esc (like me because my shell is in TotalTerminal). vim.wikia.com/wiki/Avoid_the_escape_key - anyone
  • :x == ZZ but :x != :wq. :x write file iff file has changed, :wq write file always (matter i.e. when using inotify). - anyone
  • To be honest, I have a harder time using vim's help system than using vim itself, and mostly rely on quick ref cards and online documentation. - anyone
  • if you don't have permissions on the file but have sudo permissions :w ! sudo tee % - anyone

Pictures are worth a thousand Unix commands and options:

Enter image description here

I draw this to my students each semester and they seem to grasp vi afterwards.

Vi is a finite state machine with three main states.

It starts in COMMAND mode, where you perform editor functions using very short keystroke sequences, blindly. You know what you are doing; this isn't for amateurs.

When you want to actually edit text, you should go to INSERT mode with some keystroke; common ones include:

  • i: insert just before the cursor
  • I: move to beginning of line and (i)nsert
  • a: append just after the cursor
  • A: move to end of line and (a)ppend
  • o: open a new line just below the current line
  • O: open a new line just above the current line
  • R: enter REPLACE mode (similar to INSERT mode)

Now, answering the question: exiting.

You can exit vi from EX mode:

  • q - if you haven't made any modifications, or saved them beforehand
  • q! - ignores any modifications and quit
  • wq - save and quit
  • x - this is similar to wq

w and x accept a file name parameter. If vi already knows the filename to use (e.g. it was started with vi file), you need not give it here again.

At last, the most important: how can you reach EX mode?

EX mode is for long commands that you can see typing at the bottom line of the screen. From COMMAND mode, you press colon, :, and a colon will appear at the bottom line, where you can type the above commands.

From INSERT mode, you need to push ESC, i.e. the Escape button, going to COMMAND mode, and then: to go to EX mode.

If you are unsure, push ESC and that will bring you to command mode.

The robust method is ESC-:-x-Enter which saves your file and quits.

Answered   2023-09-20 20:01:37

  • Thank you, the image is very helpful. However, for me w doesn't change from Ex to Command mode, but Esc does. What am I doing wrong? - anyone
  • If you write w-Enter that saves your file and goes back to COMMAND mode. I wrote it to have a full picture of save & quit commands. - anyone
  • oh, so you mean :w. Then it makes perfect sense. By the way, is there a command to reload from disk (that is, to revert changes but not close the file)? If so, it could be next to w in the diagram. - anyone
  • What you've labeled command mode is actually normal mode. What you've labeled ex mode is actually command mode. Ex mode is a different beast altogether! - anyone
  • @Gergely Well, I finally found the vim documentation: :help vim-modes. - anyone

Before you enter a command, hit the Esc key. After you enter it, hit the Return to confirm.

Esc finishes the current command and switches Vim to normal mode. Now if you press :, the : will appear at the bottom of the screen. This confirms that you're actually typing a command and not editing the file.

Most commands have abbreviations, with optional part enclosed in brackets: c[ommand].

Commands marked with '*' are Vim-only (not implemented in Vi).

Safe-quit (fails if there are unsaved changes):

  • :q[uit] Quit the current window. Quit Vim if this is the last window. This fails when changes have been made in current buffer.
  • :qa[ll]* Quit all windows and Vim, unless there are some buffers which have been changed.

Prompt-quit (prompts if there are unsaved changes)

  • :conf[irm] q[uit]* Quit, but give prompt when there are some buffers which have been changed.
  • :conf[irm] xa[ll]* Write all changed buffers and exit Vim. Bring up a prompt when some buffers cannot be written.

Write (save) changes and quit:

  • :wq Write the current file (even if it was not changed) and quit. Writing fails when the file is read-only or the buffer does not have a name. :wqa[ll]* for all windows.
  • :wq! The same, but writes even read-only files. :wqa[ll]!* for all windows.
  • :x[it], ZZ(with details). Write the file only if it was changed and quit, :xa[ll]* for all windows.

Discard changes and quit:

  • :q[uit]! ZQ* Quit without writing, also when visible buffers have changes. Does not exit when there are changed hidden buffers.
  • :qa[ll]!*, :quita[ll][!]* Quit Vim, all changes to the buffers (including hidden) are lost.

Press Return to confirm the command.

This answer doesn't reference all Vim write and quit commands and arguments. Indeed, they are referenced in the Vim documentation.

Vim has extensive built-in help, type Esc:helpReturn to open it.

This answer was inspired by the other one, originally authored by @dirvine and edited by other SO users. I've included more information from Vim reference, SO comments and some other sources. Differences for Vi and Vim are reflected too.

Answered   2023-09-20 20:01:37

If you want to quit without saving in Vim and have Vim return a non-zero exit code, you can use :cq.

I use this all the time because I can't be bothered to pinky shift for !. I often pipe things to Vim which don't need to be saved in a file. We also have an odd SVN wrapper at work which must be exited with a non-zero value in order to abort a checkin.

Answered   2023-09-20 20:01:37

  • I also use this to abort a git commit, or visudo, or crontab, … - anyone
  • Aborting a git commit with :q! works fine, since git's checking for a non-empty message and not a non-zero exit code. - anyone
  • I know it works, it's just that :cq doesn't require the shift key. :-) - anyone

This is the ultimate, no-nonsense, hardcore exit command for the worst-case scenarios of exiting Vim if you want out, have no idea what you've done and you don't care what will happen to the files you opened.

Ctrl-cEnterCtrl-\Ctrl-nEnter:qa!Enter

This will get you out most of the time. Most.

You might think, naively, that you can just bang Esc a few times and then do :qa!. Oh, how you would be mistaken.

See these interesting cases where hitting Esc is not enough:

  • iCtrl-ovg (you enter insert mode, then visual mode and then operator pending mode)

  • QappendEnter

  • iCtrl-ogQCtrl-r=Ctrl-k (thanks to porges for this case)

  • iCtrl-ogQCtrl-r=inputdialog('foo','bar')Enter

  • :set insertmode (this is a case when Ctrl-\Ctrl-n returns you to normal mode)

Answered   2023-09-20 20:01:37

  • @cavalcade This is an extremely general method of ensuring the editor is in normal mode then safely quitting. In normal usage all you need is :q or :wq - anyone
  • Not general enough! What about if I (a beginner) typed i<Ctrl-O>gQ<Ctrl-R>=<Ctrl-K>? - anyone
  • @porges thanks for the test case! There are also some other test cases which prove that the original method was woeful. I edited the answer to be more general now. - anyone
  • @HeikkiNaski at least for me I need Enter after Ctrl-C as well (to escape the expression register) - anyone
  • Somehow I am still stuck in it after executing these steps. - anyone

In case you need to exit Vim in easy mode (while using -y option) you can enter normal Vim mode by hitting Ctrl + L and then any of the normal exiting options will work.

Answered   2023-09-20 20:01:37

  • Yet another option: you can use Ctrl+O to leave INSERT mode temporarily then enter :q. Trick with this combination is useful in normal vim as well to execute single command and return back to INSERT mode. - anyone

Vim has three modes of operation: Input mode, Command mode & Ex mode.

Input mode - everything that you type, all keystrokes are echoed on the screen.

Command mode or Escape mode - everything that you type in this mode is interpreted as a command.

Ex mode - this is another editor, ex. It is a line editor. It works per line or based on a range of lines. In this mode, a : appears at the bottom of the screen. This is the ex editor.

In order to exit Vim, you can exit while you are in either the ex mode or in the command mode. You cannot exit Vim when you are in input mode.

Exiting from ex mode

  1. You need to be sure that you are in the Command mode. To do that, simply press the Esc key.

  2. Go to the ex mode by pressing the : key

  3. Use any of the following combinations in ex mode to exit:

    :q - quit :q! - quit without saving :wq - save & quit or write & quit :wq! - same as wq, but force write in case file permissions are readonly :x - write & quit :qa - quit all. useful when multiple files are opened like: vim abc.txt xyz.txt

Exiting from command mode

  1. Press the escape key. You probably have done this already if you are in command mode.

  2. Press capital ZZ (shift zz) - save & exit

  3. Press capital ZQ (shift zq) - exit without saving.

Answered   2023-09-20 20:01:37

  • What you're calling "ex mode" is actually called command-line mode. It allows you to enter ex commands, but with some important differences. - anyone
  • Hmm no. You're forgetting visual mode. - anyone
  • Save(?)+Exit from insert mode: Alt Z Z That is, press: alt-shift-z then shift-z Fun fact: From insert mode, you can exit to command mode and do a command by holding Alt with the command character. - anyone
  • I think what you refer to with "ex mode" is the normal, or "command" mode. To enter the ex-mode you have to press Q. In that mode you can enter one command after another without pressing : every time. To exit ex-mode you can type :vi or :visual - anyone

After hitting ESC (or cmd + C on my computer) you must hit : for the command prompt to appear. Then, you may enter quit.

You may find that the machine will not allow you to quit because your information hasn't been saved. If you'd like to quit anyway, enter ! directly after the quit (i.e. :quit!).

Answered   2023-09-20 20:01:37

I got Vim by installing a Git client on Windows. :q wouldn't exit Vim for me. :exit did however...

Answered   2023-09-20 20:01:37

  • Similarly for vim doing git on a macintosh this worked. - anyone
  • @Joel just checked this on my mac, both commands are legit (vim -version 7.3). - anyone
  • For Git Bash on windows, in Vim sometimes ESC not working. use CTRL + [ instead. - anyone
  • @Val That looks strangely familiar. Iirc that's because the two do the same thing. As in ^[ is the same as ESC. That's interesting that Windows makes it more complicated. And amusing. - anyone

The q command with a number closes the given split in that position.

:q<split position> or :<split position>q will close the split in that position.

Let's say your Vim window layout is as follows:

-------------------------------------------------
|               |               |               |
-------------------------------------------------
|               |               |               |
|               |               |               |
|    Split 1    |    Split 2    |     Split 3   |
|               |               |               |
-------------------------------------------------

If you run the q1 command, it will close the first split. q2 will close the second split and vice versa.

The order of split position in the quit command does not matter. :2q or :q2 will close the second split.

If the split position you pass to the command is greater than the number of current splits, it will simply close the last split.

For example, if you run the q100 on the above window setup where there are only three splits, it will close the last split (Split 3).

The question has been asked here.

Answered   2023-09-20 20:01:37

One guaranteed way is to kill the port that runs vim

! kill - 9 $(ps | grep vim | cut -d " " -f 1)

Answered   2023-09-20 20:01:37

  • better way is killall -9 vim && killall -9 vi - anyone
  • doesn't work in my powershell on windows - anyone
  • @SarveshM.D better use a || instead of a && here, otherwise the second command won't have any effect - anyone
  • @SarveshM.D sometime it's neovim running, then your solution won't work - anyone

From any of four modes: insert, visual, command or command-line (ex) mode, press this to save if changed then exit vim:

Alt-Z Z

That is, press: alt + shift + z then shift + z

Why this works: From insert mode and apparently other modes, you can exit to command mode and do a command by the combination of holding Alt with any command character. The second Alt+Shift+Z is ignored, so you must let go of the Alt but keep the Shift. Work that muscle memory! :-)

Answered   2023-09-20 20:01:37

Q-first vs. Colon-first

Many people know about the colon-q exit strategy. But for extra strategery and posterity, here is the q-colon-i-q method:

In Normal mode you can type:

q:iq<enter>

If you look closely and squint, you can almost read that command aloud as "quick," since this is the slow way to exit.

(Note: my attempt at humor notwithstanding, this does work!)

Answered   2023-09-20 20:01:37