Vim과 Neovim

Vim이란

Vim은 모드(mode)를 나눠 키 입력의 의미를 바꾸는 터미널 텍스트 편집기다. 입력 모드에서는 글자를 쓰고, 노멀 모드에서는 같은 키가 이동·삭제·복사 명령이 된다. 마우스 없이 손을 홈 row에 둔 채 편집할 수 있고, 거의 모든 유닉스 계열 서버에 vi가 깔려 있어 SSH로 접속한 환경에서도 바로 쓸 수 있다. Git 커밋 메시지의 기본 편집기도 대개 Vim이다.

Vim의 문법: 동사 + 대상

노멀 모드 명령은 외울 단축키 목록이 아니라 조합하는 언어다. 기본 형태는 [횟수] 동사 [대상]이다.

요소	예
동사(operator)	`d` 삭제, `c` 바꾸기, `y` 복사, `>` 들여쓰기, `gU` 대문자로
대상(motion)	`w` 다음 단어, `$` 줄 끝, `fa` 다음 `a`까지, `}` 문단 끝
텍스트 객체	`iw` 단어 안, `i"` 따옴표 안, `ap` 문단 전체, `it` 태그 안

dw(단어 삭제), 3dw(세 단어 삭제), d3fa(세 번째 a까지 삭제), ciw(단어를 바꿔 쓰기)처럼 동사 몇 개와 대상 몇 개만 알아도 조합이 곱으로 늘어난다. 수식 키를 겹쳐 누르는 IDE 단축키와 달리 규칙이 일정해 외울 것이 적다. 명령 하나는 텍스트를 바꾸는 함수이므로, .으로 마지막 변경을 반복하고, 매크로(qa…q, @a)로 새 동사를 만들고, :g/패턴/normal @a로 맞는 줄마다 적용할 수 있다.

Vim은 편집기이면서 플랫폼이기도 하다. 세션으로 작업별 창 배치를 저장하고, :%!column -t처럼 버퍼를 외부 명령으로 걸러 표 정리·계산을 맡기고, Vimscript·Lua로 자기 작업 흐름(블로그, 할 일 관리, 위키)을 만든다.

계보: ed → vi → Vim → Neovim

편집기	등장	특징
ed	1969, 유닉스	한 줄씩 다루는 라인 편집기. 줄을 찾고 고른 뒤 고치고 다시 출력해 확인해야 했다
vi	1976, Bill Joy	화면 전체를 보며 편집하는 visual 편집기. 모드와 `hjkl` 이동이 이때 생겼다
Vim	1991, Bram Moolenaar	vi 호환 + 구문 강조, 다단계 실행 취소, 분할 창, 스크립트(Vimscript). 이름은 Vi IMproved
Neovim	2014	Vim을 포크해 코드를 정리하고 Lua 설정·비동기 작업·내장 LSP를 넣었다

vi의 hjkl 이동과 Esc 모드 전환은 당시 터미널(ADM-3A) 키보드에서 나왔다. 그 키보드는 hjkl에 화살표가 그려져 있었고 Esc가 지금의 Tab 자리에 있었다.
Bram Moolenaar가 2023년 세상을 떠난 뒤 Vim은 커뮤니티 메인테이너들이 이어 개발한다. 2026년 기준 최신 안정 버전은 9.2다.
Neovim은 Vim 9의 Vim9 script를 받아들이지 않고 Lua 중심으로 따로 발전한다. 2026년 기준 0.12 계열이며, 0.12부터 내장 플러그인 관리자 vim.pack 을 제공한다.

Vim과 Neovim, 무엇을 고를까

	Vim	Neovim
설정 파일	`~/.vimrc`	`~/.config/nvim/init.lua` (또는 `init.vim`)
설정 언어	Vimscript, Vim9 script	Lua (Vimscript도 동작)
LSP·자동 완성	플러그인(coc.nvim, vim-lsp 등)	내장 LSP 클라이언트, 내장 자동 완성
기본값	vi 호환에 가까움	구문 강조·검색 강조 등 쓸 만한 기본값이 켜져 있음
어디에나 있나	대부분의 서버에 기본 설치	직접 설치해야 함 (`brew install neovim`)

서버에서 잠깐 파일을 고치는 용도면 Vim(또는 vi)으로 충분하다. 매일 쓰는 주 편집기로 IDE처럼 꾸밀 생각이면 Neovim이 설정이 쉽고 생태계가 활발하다. 노멀 모드 명령은 둘이 같으므로 어느 쪽을 익혀도 그대로 옮겨 간다.

플러그인 관리

Vim도 VS Code의 확장처럼 플러그인으로 기능을 더한다.

방법	쓰는 법
Vim 내장 패키지	`~/.vim/pack/plugins/start/` 아래에 플러그인 저장소를 clone하면 시작할 때 자동으로 읽는다
vim-plug	`.vimrc`에 `Plug 'user/repo'`를 나열하고 `:PlugInstall`
Neovim `vim.pack`	`vim.pack.add({ 'https://github.com/user/repo' })` (0.12+)
lazy.nvim	Neovim용. 필요할 때만 플러그인을 불러와 시작이 빠르다

과거에는 Vundle(Plugin 'user/repo' + :PluginInstall)이 많이 쓰였지만 지금은 거의 관리되지 않는다. IDE처럼 꾸밀 때 자주 고르는 기능은 다음과 같다.

기능	대표 플러그인
하단 상태 줄(모드, 파일 경로, 줄 번호)	vim-airline, lightline (Neovim: lualine)
파일 트리	NERDTree, fern (Neovim: nvim-tree, neo-tree)
파일 아이콘	vim-devicons. 터미널 폰트를 Nerd Font로 바꿔야 아이콘이 보인다
퍼지 검색	fzf.vim (Neovim: telescope.nvim)

편집 기술

설정은 ~/.vimrc(Neovim은 init.vim/init.lua)에 적으면 매번 적용되고, 노멀 모드에서 :set ...으로 치면 그 세션에만 적용된다. 아래 예시는 Vimscript 기준이며 Neovim에서도 그대로 동작한다.

1. 공백 문자 보이기: list, listchars

탭과 스페이스, 줄 끝 공백은 눈에 안 보여서 들여쓰기 규칙 위반의 흔한 원인이 된다. list를 켜면 이들을 기호로 표시한다.

set list                               " :set list! 로 켜고 끄기
set listchars=tab:\|.,trail:-,eol:$

항목	뜻	위 설정의 표시
`tab:xy[z]`	x = 탭의 첫 글자, y = 탭 폭만큼 채우는 글자, z = 마지막 글자(선택)	`\|...`
`trail`	줄 끝에 붙은 공백	`-`
`eol`	줄 끝	`$`
`space`, `lead`, `nbsp`	모든 공백, 줄 앞 공백, 줄바꿈 없는 공백	지정한 글자

|처럼 특별한 의미가 있는 글자는 \로 이스케이프한다. 색은 하이라이트 그룹으로 바꾼다. eol은 NonText, 탭·공백 계열은 Vim에서 SpecialKey, Neovim에서 Whitespace 그룹을 쓴다(:highlight Whitespace guifg=#ddff00).

2. 코드 접기: fold

set foldmethod=marker   " manual, indent, syntax, expr, marker 중 하나
set foldlevel=0         " 0이면 열 때 모두 접힘, 99면 모두 펼침

marker 방식은 주석 안에 {{{와 }}}를 넣어 접을 범위를 직접 표시한다. 코드에 영향을 주지 않도록 주석 줄에 쓴다. 표시 없이 들여쓰기 기준으로 접으려면 indent가 편하다.

명령	동작
`zo` / `zc`	커서 위치의 접기 열기 / 닫기
`zO` / `zC`	커서 위치를 재귀적으로 모두 열기 / 닫기
`za`	열기·닫기 토글
`zR` / `zM`	파일 전체 열기 / 닫기

3. 연속된 숫자 입력하기

방법	쓰는 법
`Ctrl-a` / `Ctrl-x`	커서 위치의 숫자를 1 늘리기 / 줄이기. 앞에 숫자를 붙이면 그만큼(`5 Ctrl-a`)
`g Ctrl-a`	`Ctrl-v`로 여러 줄의 숫자를 세로로 고른 뒤 누르면 1, 2, 3…처럼 줄마다 누적해서 증가
`:put=range(a, b)`	a부터 b까지 정수를 한 줄씩 삽입
`:put=map(range(...), 'printf(...)')`	숫자를 서식 문자열에 끼워 여러 줄 생성

:put=range(1, 5)
:put=map(range(1, 9), 'printf(''%d * %d = %d'', v:val, v:val, v:val * v:val)')

range(10, 0, -2)처럼 세 번째 인자로 간격을 주면 감소하거나 건너뛰는 수열도 만든다.

4. 조건에 따라 다르게 동작하는 키 매핑: `<expr>`

보통의 매핑은 키를 다른 키 입력으로 바꾼다. nnoremap의 nore는 매핑 결과가 다시 매핑되는 재귀를 막는다.

nnoremap n nzzzv       " 다음 검색 결과로 가며 화면 가운데로 맞춤

<expr>을 붙이면 오른쪽을 식으로 평가한 결과를 키 입력으로 쓴다. 상태에 따라 토글하거나, 창이 있으면 그리로 가고 없으면 새로 여는 매핑을 만들 수 있다.

" 열린 터미널 버퍼가 있으면 그 버퍼를, 없으면 새 터미널을 오른쪽 분할 창에 연다
nnoremap <expr> <leader>tt ToggleTerm()
function! ToggleTerm()
  let terms = filter(getbufinfo(), 'getbufvar(v:val.bufnr, "&buftype") ==# "terminal"')
  return empty(terms) ? ":vsplit \| terminal\<CR>" : ":vsplit \| buffer " . terms[0].bufnr . "\<CR>"
endfunction

식이 길어지면 이렇게 함수로 빼야 읽기 쉽다. 자세한 규칙은 :help map-<expr>.

5. 복사한 영역 잠깐 강조하기

yy 같은 복사(yank)는 화면에 아무 표시가 없어 제대로 복사됐는지 헷갈린다. Neovim은 복사 직후 그 영역을 잠깐 강조하는 함수를 내장한다.

-- init.lua
vim.api.nvim_create_autocmd('TextYankPost', {
  callback = function() vim.hl.on_yank({ higroup = 'IncSearch', timeout = 300 }) end,
})

autocmd는 특정 이벤트(여기서는 TextYankPost, 텍스트가 복사된 직후)가 일어날 때 명령을 자동으로 실행한다. timeout 기본값은 150ms이고, on_visual, on_macro로 비주얼 모드·매크로에서의 동작을 정한다. 옛 이름은 vim.highlight.on_yank이며, 오래된 설정 예시에서는 이 이름과 autocmd TextYankPost * lua ... 형태를 볼 수 있다. Vim에서는 vim-highlightedyank 플러그인으로 같은 효과를 낸다.

6. 시스템 클립보드로 복사하기

Vim의 복사는 기본적으로 Vim 내부 레지스터에만 들어가서 다른 앱에 붙여 넣을 수 없다. 터미널에서 마우스로 긁으면 줄 번호까지 같이 복사되기도 한다.

방법	쓰는 법
`"+y`	시스템 클립보드 레지스터(`+`)로 복사. `"+p`로 붙여 넣기
`set clipboard=unnamedplus`	모든 `y`/`p`가 시스템 클립보드를 쓰게 함
`set mouse=a`	마우스 선택을 Vim이 받아 비주얼 모드로 다룸

Vim은 +clipboard 기능을 넣고 빌드한 버전에서만 된다(vim --version | grep clipboard로 확인). Neovim은 macOS에서는 바로, Linux에서는 xclip·wl-clipboard 같은 도구가 있으면 된다.

7. 플러그인 없이 자동 완성

입력 모드에서 플러그인 없이 쓸 수 있는 완성이 있다.

키	완성 대상
`Ctrl-n` / `Ctrl-p`	`complete` 옵션에 정한 출처의 단어(다음·이전 후보)
`Ctrl-x Ctrl-l`	줄 전체
`Ctrl-x Ctrl-f`	파일 이름·경로 (`~/` 뒤에서 누르면 홈 디렉터리 항목)
`Ctrl-x Ctrl-k`	`dictionary` 옵션의 사전 파일 단어
`Ctrl-x Ctrl-]`	태그 파일(ctags)의 식별자
`Ctrl-x Ctrl-o`	옴니 완성. 파일 형식별 함수나 LSP가 문맥에 맞는 후보를 준다
`Ctrl-x s`	맞춤법 교정 후보

complete 옵션은 단어를 어디서 찾을지 정한다. 기본값 .,w,b,u,t,i는 현재 버퍼, 다른 창, 열린 버퍼, 닫힌 버퍼, 태그, include 파일 순이다. 메뉴 동작은 completeopt(예: menuone,noselect)로 정한다. Neovim은 LSP 클라이언트를 내장해 언어 서버 기반 완성을 쓸 수 있다.

자주 틀리는 말이나 긴 문구는 완성 대신 약어(:iabbrev teh the)로 바로 펼친다.

8. Vim으로 개인 위키 쓰기

Vimwiki 플러그인은 단어 위에서 Enter를 누르면 그 이름의 문서와 링크를 함께 만든다. 문서를 마크다운으로 쓰고 git 저장소에 두면 기기 간 동기화와 변경 이력이 따라오고, 정적 사이트 생성기(Jekyll 등)와 GitHub Pages로 그대로 공개 사이트가 된다.

문서 머리의 front matter에 수정일·상위 문서·태그를 두고, 저장 시 수정일 갱신, 커밋 전 훅(pre-commit)으로 메타데이터·목록 생성을 자동화한다.
링크 문법은 편집기와 사이트 양쪽이 인식하는 형식으로 통일한다. 형식이 섞이면 이름 바꾸기 같은 기능이 깨진다.
외부에 올린 이미지는 서비스 정책이 바뀌면 사라지므로 커밋할 때 저장소로 내려받아 둔다.

편집기 밖에서 Vim 쓰기

man 페이지를 Vim으로 열기

셸 설정 파일(~/.zshrc 등)에 MANPAGER를 지정하면 man printf가 Vim으로 열린다.

export MANPAGER="nvim +Man!"                          # Neovim
export MANPAGER="vim +MANPAGER --not-a-term -"        # Vim

Vim의 검색·복사·색 구성을 그대로 쓸 수 있고, 본문의 다른 명령 이름 위에서 K 또는 Ctrl-]로 그 매뉴얼로 건너가고 Ctrl-o(또는 Ctrl-t)로 돌아온다. Vim 안에서는 :Man 3 printf로 바로 열 수 있다.

브라우저를 Vim 키로: Vimium

Vimium은 Chrome·Edge용 확장이다. f를 누르면 클릭할 수 있는 모든 링크에 글자 힌트가 붙어 키보드로 누를 수 있고, j/k로 스크롤, H/L로 뒤로·앞으로 간다. ?로 전체 단축키를 본다. Firefox에는 같은 계열의 Vimium-FF, Tridactyl이 있다.

스왑 파일과 `E325: ATTENTION`

Vim은 파일을 열면 편집 내용을 스왑 파일에 계속 기록한다. Vim에서는 같은 폴더의 숨김 파일 .파일이름.swp, Neovim에서는 ~/.local/state/nvim/swap/ 아래에 생긴다. 정상 종료하면 지워지고, 터미널이 강제로 닫히거나 프로세스가 죽으면 남는다. 다음에 같은 파일을 열 때 남은 스왑 파일을 발견하면 E325: ATTENTION 경고와 함께 고르게 한다.

선택	쓰는 때
`(O)pen Read-Only`	다른 Vim이 정말 그 파일을 열고 있을 때. 경고의 `process ID`가 아직 살아 있으면 이 경우다
`(R)ecover`	저장 못 하고 죽은 편집 내용을 되살린다. 확인 후 저장하고, 남은 스왑 파일은 지운다
`(D)elete it`	되살릴 것이 없을 때 스왑 파일을 지우고 연다
`(E)dit anyway` · `(Q)uit` · `(A)bort`	무시하고 열기 / 닫기

Git이 커밋 메시지를 Vim으로 받다가 끊기면 .git/.COMMIT_EDITMSG.swp가 남아 다음 git commit마다 이 경고가 뜬다. D를 고르거나, 경고에 적힌 경로의 파일을 rm으로 지운다. 숨김 파일이라 ls -a로 봐야 보인다.

정리

Vim은 모드를 나눠 같은 키로 입력과 명령을 오가는 편집기이고, vi의 후계다.
Neovim은 Vim의 포크로 Lua 설정과 내장 LSP·플러그인 관리자를 갖췄다. 노멀 모드 명령은 같다.
플러그인은 내장 패키지·vim-plug·vim.pack·lazy.nvim으로 관리한다. Vundle은 옛 방식이다.
공백은 listchars로 드러내고, 긴 파일은 foldmethod로 접고, 숫자 수열은 g Ctrl-a나 :put=range()로 넣는다.
<expr> 매핑으로 상황에 따라 다르게 동작하는 키를 만들고, 다른 앱과 주고받는 복사는 + 레지스터를 쓴다.
MANPAGER와 Vimium으로 Vim 키를 매뉴얼과 브라우저까지 넓힐 수 있다.
E325: ATTENTION은 스왑 파일이 남았다는 뜻이다. 다른 Vim이 열고 있지 않으면 복구하거나 지운다.

관련 노트: tmux, VS Code 설정과 활용

버그 제보