Neovim 로드맵 — 편집 모델·상태·확장 구조

Neovim은 Vim의 모달 편집 모델을 계승하면서 편집기 상태를 API로 노출하고 플러그인·외부 프로세스와 연동하는 확장 가능한 편집기다. 이 로드맵은 기존 글의 학습 순서가 아니라 Neovim 자체의 구성요소와 관계를 보여준다. 세부 문서의 존재 여부는 지도에 포함할 개념을 결정하지 않는다.

전체 개념지도

Neovim
├─ 편집 모델
│  ├─ Mode / Operator / Motion / Text Object
│  └─ Register / Mark / Macro / Undo
├─ 편집기 상태
│  ├─ Buffer ── 문서 내용과 편집 상태
│  ├─ Window ── Buffer를 표시하는 View
│  ├─ Tabpage ── Window 레이아웃의 집합
│  └─ Option / Keymap / Command
├─ Runtime·확장
│  ├─ Lua / Vimscript / vim.api / vim.fn
│  ├─ Event / Autocommand / Async / Job / RPC
│  └─ Plugin / runtimepath / Package
├─ 언어·개발 도구 통합
│  ├─ Treesitter ── 구문 구조·하이라이트 등에 활용
│  ├─ LSP Client ↔ Language Server
│  └─ DAP Client ↔ Debug Adapter ↔ Debugger
└─ UI·설정
   ├─ Built-in TUI / External UI
   ├─ User Config / Plugin Manager
   └─ LazyVim 등 선택적 설정 배포판

핵심 관계
편집 동작 ──> Buffer의 내용·상태 변경
Window ──displays──> Buffer (여러 Window가 같은 Buffer 표시 가능)
Tabpage ──contains──> Window (Window는 해당 Tabpage에 속함)
Plugin ──uses──> Runtime API ──reads/modifies──> 편집기 상태

이 지도에서 편집 모델은 사용자가 어떤 동작을 요청하는지, 편집기 상태는 무엇을 표시·변경하는지, Runtime API는 기능을 어떻게 확장하는지를 구분한다. 각 개념은 기존 게시글의 유무와 관계없이 필요한 위치에 놓는다.

핵심 개념과 관계

편집 모델과 편집기 상태

Mode는 키 입력이 어떤 편집 동작으로 해석되는지에 영향을 준다. Operator는 Motion 또는 Text Object와 결합해 범위를 대상으로 동작할 수 있다. Register는 yank·delete 등의 결과를 보관하고, Undo는 변경 이력을 관리한다.

Tabpage
├─ Window A ──displays──> Buffer X
└─ Window B ──displays──> Buffer X

다른 Tabpage의 Window도 Buffer X를 표시할 수 있음

Buffer는 문서 내용의 중심이고 Window는 이를 표시하는 뷰다. Tabpage는 Window들의 배치를 구성한다. 관련 설명은 Vim·Neovim 작동 원리와 Register를 참고한다. 기본 키 조작은 Devkit Vim Cheatsheet에서 확인할 수 있다.

Runtime API와 플러그인

Neovim은 Lua·Vimscript와 API를 통해 Buffer·Window·Option 등 편집기 상태를 조회·변경할 수 있다. Autocommand는 특정 Event에 반응하도록 기능을 연결하고, Job·RPC는 외부 프로그램과 상호작용하는 통로를 제공한다.

Plugin / User Config
        │
        ├─ Runtime API ──> Buffer / Window / Option
        ├─ Event ──> Autocommand
        └─ Job / RPC ──> External Process

세부 구조는 Neovim API 지도, Buffer·Window·Extmark, Autocommand·Event, 비동기·Job에서 필요에 따라 살펴본다.

외부 개발 도구와 UI

Neovim의 LSP Client는 Language Server와 프로토콜로 통신하고, DAP 연동은 Debug Adapter를 통해 디버거 기능을 제공한다. Treesitter는 구문 트리를 활용하는 별도의 기능군이다. 이들은 플러그인 제작의 후속 단계가 아니라 편집기 기능을 구성하는 서로 다른 통합 경로다.

LSP는 Mason·nvim-lspconfig·vim.lsp의 역할, DAP는 Debug Adapter Protocol에서 더 자세히 다룬다. 터미널 UI의 입출력 구조는 Terminal 로드맵과 연결된다.

필요한 경우 더 깊이 살펴보기

전체 지도의 개념을 이해하는 데 별도 문서가 필수인 것은 아니다. 특정 개념의 원리나 구현이 궁금할 때만 아래 자료로 이동한다.

• 편집 상태와 내부 구조: Vim·Neovim 작동 원리, Buffer·Window·Extmark
• 확장 API: Neovim API 지도, Autocommand·Event
• 외부 개발 도구: LSP, DAP
• 선택적 설정·확장: LazyVim 기능 지도, Plugin 구조

다른 로드맵과의 경계

Neovim의 편집 모델·상태·API는 이 문서에서 다룬다. Terminal은 PTY·터미널 렌더링, tmux는 세션·pane 관리, dotfiles는 설정 파일의 머신 간 재현을 다룬다. 일반적인 프로그래밍 언어·운영체제 개념은 해당 개념지도에서 확인한다.