Tag 11: Neovim-Grundlagen für Terminal-Menschen
Ziel: Dateien mit vim-Motions, Textobjekten und Makros schneller ändern als mit der Maus. · Dauer: ca. 90 min · Voraussetzung: Tag 10
Briefing
- vim ist eine Sprache: Operator + Motion/Textobjekt,
zum Beispiel
d+woderc+i". - Eine Zahl davor wiederholt:
d3w. Der Punkt.wiederholt die letzte Änderung. - Die Konfiguration ist eine einzige
init.luavon rund 60 Zeilen. Eine Distribution wie LazyVim brauchst du dafür nicht. - Das Lab-Neovim startet über das Skript
nv. Es biegt nur die XDG-Pfade um, deine echte~/.config/nvimbleibt unberührt.
d 3 w c i "
│ │ └ Motion │ │ └ Objekt: "…"
│ └ Anzahl │ └ inner (ohne Rand) / a = around (mit Rand)
└ Operator └ Operator
Drill 1: Lab-Neovim einrichten
Kopiere init.lua und das Wrapper-Skript nv
ins Übungs-Home. ~/term-lab/bin steht in der Lab-zsh schon
im PATH (Tag 0):
mkdir -p ~/term-lab/config/nvim
cp $BUCH/nvim/init.lua ~/term-lab/config/nvim/init.lua
cp $BUCH/nvim/nv ~/term-lab/bin/nv && chmod +x ~/term-lab/bin/nv
cat ~/term-lab/bin/nvErwartet:
#!/bin/sh
# nv – Neovim mit Lab-Konfiguration (Tag 11).
# Echte ~/.config/nvim, ~/.local/share/nvim und ~/.local/state/nvim bleiben unberührt.
LAB="${LAB:-$HOME/term-lab}"
export XDG_CONFIG_HOME="$LAB/config" \
XDG_DATA_HOME="$LAB/share" \
XDG_STATE_HOME="$LAB/state" \
XDG_CACHE_HOME="$LAB/cache"
exec nvim "$@"
Jetzt prüfst du die Konfiguration ohne Oberfläche:
nvim --headless -u ~/term-lab/config/nvim/init.lua +q && echo "init.lua ok"
nv --headless +'lua print(vim.fn.stdpath("config"), vim.o.clipboard)' +q; echoErwartet:
init.lua ok
/Users/<du>/term-lab/config/nvim unnamedplus
Ein Fehler in der init.lua erscheint hier als
Lua-Stacktrace mit Zeilennummer. Das ist der schnellste Test nach jeder
Änderung.
Tipp: Alternativ trennt
NVIM_APPNAME=lab nvimKonfigurationen. Das legt aber~/.config/laban. Der Wrapper hält dagegen alles unter~/term-lab.
Die Übungsdateien für heute:
mkdir -p ~/term-lab/tag11 && cd ~/term-lab/tag11
cat > server.py <<'EOF'
# TODO: Konfig aus Umgebung lesen
import os
def connect(host, port):
url = "http://localhost:8080/api"
print("connecting to", host, port)
return {"host": host, "port": port, "timeout": 30}
def disconnect(conn):
print("closing", conn["host"])
EOF
printf 'web-01\nweb-02\ndb-01\ncache-01\n' > hosts.txt
git init -q && git add . && git commit -qm "start"Das Mini-Repo (mit der Lab-Gitconfig aus Tag 10) ist dein Undo über
Dateigrenzen hinweg: git restore server.py setzt eine Übung
zurück, git diff zeigt, was du geändert hast.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Motions
nv server.py öffnet die Datei. Die relativen
Zeilennummern zeigen dir, welche Zahl vor j oder
k gehört. Tippe nacheinander und beobachte den Cursor:
gg G 5G } { Datei-Anfang/-Ende, Zeile 5, Absatz vor/zurück
w b e W B Wort vor/zurück/Wortende, WORT = bis Leerzeichen
0 ^ $ Zeilenanfang, erstes Zeichen, Zeilenende
f( t, ; , zu "(" / bis vor "," springen, wiederholen vor/zurück
% zur passenden Klammer
/connect<CR> n N suchen, nächster/voriger Treffer
* # Wort unter dem Cursor vorwärts/rückwärts suchen
Jetzt mit Operator. Jede Zeile ist eine eigene Aufgabe,
u macht sie rückgängig:
/print<CR>f(ldt, löscht bis vor das Komma
/def connect<CR>wd2w löscht "connect("
/return<CR>f{%x springt zur schließenden } und löscht sie
Erwartet (Zeile nach der jeweiligen Aufgabe):
print(, host, port)
def host, port):
return {"host": host, "port": port, "timeout": 30
Tipp:
ciwschlägt fast immerdw+i. Merke: lieber Textobjekte als zählen.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Textobjekte
Textobjekte wirken egal, wo im Objekt der Cursor steht.
i heißt inner, a heißt around.
/localhost<CR>ciwexample<Esc> Wort ersetzen
/connecting<CR>ci"verbinde mit<Esc> Inhalt der Anführungszeichen ersetzen
/30<CR>cw60<Esc> Zahl ersetzen
/return<CR>f{di{ Inhalt der geschweiften Klammern leeren
Gdap letzten Absatz (Funktion) löschen
Erwartet (geänderte Zeilen, jeweils nach u zurück auf
das Original):
url = "http://example:8080/api"
print("verbinde mit", host, port)
return {"host": host, "port": port, "timeout": 60}
return {}
(def disconnect … ist weg)
| Objekt | Bedeutung | Beispiel |
|---|---|---|
iw / aw |
Wort / mit Leerzeichen | ciw, daw |
i" / a" |
in/um Anführungszeichen | ci", da" |
i( / i{ / i[ |
in Klammern | di(, yi{ |
it / at |
in/um HTML-Tag | cit |
ip / ap |
Absatz | yap, dap |
y kopiert, und dank clipboard=unnamedplus
landet das direkt in der macOS-Zwischenablage. Probiere
yi{, dann im Terminal pbpaste (Tag 12).
Fortschritt speichern? Kostenlos registrieren
Drill 4: Punkt-Befehl und cgn
. wiederholt die letzte Änderung. Zusammen mit
cgn („ändere nächsten Treffer“) wird daraus ein Suchen und
Ersetzen mit Augenmaß. Du benennst den Parameter host um,
der Dictionary-Schlüssel "host" soll bleiben.
/(host<CR>l Cursor auf den Parameter host
*N Wort als Suchmuster setzen, zurück auf den ersten Treffer
cgnhostname<Esc> ersten Treffer ändern
. nächster Treffer (print-Zeile)
nn "host"-Schlüssel überspringen
. Wert host im Dictionary ändern
:w<CR>
grep -n host server.pyErwartet:
5:def connect(hostname, port):
6: url = "http://localhost:8080/api"
7: print("connecting to", hostname, port)
8: return {"host": hostname, "port": port, "timeout": 30}
12: print("closing", conn["host"])
Warum nn? Nach . steht der Cursor vor dem
nächsten Treffer. Das erste n springt auf den Schlüssel,
das zweite darüber hinweg. . ändert immer den Treffer ab
Cursor.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Makros
Aus der Host-Liste soll eine YAML-Liste werden. Öffne
nv hosts.txt und tippe:
qa Aufnahme in Register a
I - name: <Esc> Präfix einfügen
j eine Zeile runter
q Aufnahme beenden
3@a dreimal abspielen
:w<CR>
cat hosts.txtErwartet:
- name: web-01
- name: web-02
- name: db-01
- name: cache-01
Die Regel für robuste Makros: Starte am Zeilenanfang (0
oder I), ende auf der nächsten Zeile. Dann lässt sich das
Makro beliebig oft abspielen, auch per :%normal @a.
Tipp:
@@wiederholt das zuletzt abgespielte Makro.:reg azeigt, was aufgenommen wurde.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Suchen, Ersetzen und Quickfix
Setz server.py zurück und ersetze port nur
dort, wo es Variable ist:
git restore server.py
nv server.py:%s/\<port\>\ze[,)]/port_nr/gc
:w<CR>
\< und \> sind Wortgrenzen,
\ze beendet den Treffer vor , oder
). Mit y/n bestätigst du jeden
Treffer, die Vorschau (inccommand=split) zeigt alle
vorab.
Erwartet (nach y, y, n,
geänderte Zeilen):
def connect(host, port_nr):
print("connecting to", host, port_nr)
return {"host": host, "port": port, "timeout": 30}
Über mehrere Dateien gehst du mit :grep (dank
grepprg ist das ripgrep) und der Quickfix-Liste:
mkdir -p pkg
printf 'package main\n\n// TODO: Fehler behandeln\nfunc main() {}\n' > pkg/main.go
nv:silent grep! TODO Treffer in die Quickfix-Liste
:copen Liste anzeigen, Enter springt hin
:cdo s/TODO/FIXME/ | update in jedem Treffer ersetzen und speichern
:qa
rg -n FIXMEErwartet:
pkg/main.go:3:// FIXME: Fehler behandeln
server.py:1:# FIXME: Konfig aus Umgebung lesen
:g/print/d löscht alle Zeilen mit print,
:g!/def/d alle ohne def. Das ist
grep -v direkt im Buffer.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Fenster, Buffer und Dateien finden
Starte nv im Ordner tag11 und arbeite ohne
Maus (mouse="" ist Absicht):
<Space>ff main<Tab><CR> :find mit ** findet pkg/main.go
:vs server.py<CR> vertikaler Split
<C-h> <C-l> zwischen Fenstern wechseln (eigene Mappings)
:ls<CR> offene Buffer
:b#<CR> zum vorigen Buffer, wie git co -
<Space>e netrw im aktuellen Ordner, - geht eine Ebene hoch
<C-o> <C-i> Sprungliste zurück/vor
Die Leader-Mappings fragst du die Konfiguration selbst ab:
nv --headless +'lua for _, m in ipairs(vim.api.nvim_get_keymap("n")) do
if m.lhs:find("^ ") then print(m.lhs, m.desc) end end' +qa; echoErwartet:
fg Grep ins Quickfix
ff Datei finden (eingebaut)
e Dateibrowser (netrw)
q Fenster schließen
w Speichern
Für große Repos lohnt ein Fuzzy Finder. Die init.lua
bringt fzf-lua optional mit, installiert über den in
Neovim 0.12 eingebauten Paketmanager vim.pack:
LAB_PLUGINS=1 nv --headless +'lua print(vim.pack.get()[1].spec.name)' +qa; echoErwartet (beim ersten Mal mit Download-Meldungen):
vim.pack: 100% Installing plugins (1/1) - fzf-lua
fzf-lua
Danach ersetzen <Space>ff,
<Space>fg und <Space>fb die
eingebauten Varianten durch fzf-Picker. Das Plugin liegt unter
~/term-lab/share/nvim/site/pack/core/opt/.
Tipp: Telescope ist die bekannteste Alternative zu fzf-lua. Fertige Distributionen wie LazyVim lohnen sich erst, wenn du die Grundlagen hier sicher kannst – sonst weißt du nicht, welche Taste woher kommt.
Fortschritt speichern? Kostenlos registrieren
Drill 8: Neovim als $EDITOR
Git, zsh und viele CLIs öffnen $EDITOR. Im Lab ist das
nv:
export EDITOR=nv VISUAL=nv
git config --global core.editor nv
git config --global core.editorErwartet:
nv
git config --global schreibt hier dank
GIT_CONFIG_GLOBAL in ~/term-lab/gitconfig.
Damit es dauerhaft gilt, ersetzt du in
~/term-lab/zsh/.zshenv die Zeile
export EDITOR=nvim VISUAL=nvim durch
export EDITOR=nv VISUAL=nv. Nützliche Aufrufe ab jetzt:
nv +3 server.py # direkt in Zeile 3
nv -q <(rg --vimgrep FIXME) # rg-Treffer als Quickfix-Liste
nv -d server.py pkg/main.go # Diff-Modus, ]c/[c springen
git log --oneline | nv - # stdin als BufferErwartet bei nv -q … (Statuszeile unten):
(1 of 2): // FIXME: Fehler behandeln
In der zsh öffnet ⌃X⌃E die aktuelle Befehlszeile in
$EDITOR (Tag 3). Nach :wq steht der
bearbeitete Befehl wieder am Prompt.
Fortschritt speichern? Kostenlos registrieren
Shortcut-Tabelle
| Taste | Wirkung | Merkhilfe |
|---|---|---|
ciw / ci" / di( |
Wort / String / Klammerinhalt ändern | change inner |
dap / yap |
Absatz löschen / kopieren | delete a paragraph |
f t ; , |
in der Zeile springen, wiederholen | find, till |
* + cgn + . |
Treffer für Treffer ersetzen | gn = go next |
qa … q, @a,
@@ |
Makro aufnehmen, abspielen, wiederholen | q = queue |
g⌃A (visuell) |
Zahlen fortlaufend hochzählen | g = gestaffelt |
⌃O / ⌃I |
Sprungliste zurück / vor | Out / In |
:cdo + Befehl + update |
Befehl auf alle Quickfix-Treffer | c = Quickfix |
Leertaste ff / fg |
Datei finden / grep | find file / grep |
Kontrollpunkt
cd ~/term-lab/tag11
ok() { if eval "$1" >/dev/null 2>&1; then echo "✔ $2"; else echo "✘ $2"; fi; }
ok 'nvim --headless -u ~/term-lab/config/nvim/init.lua +q' "init.lua lädt fehlerfrei"
ok '[ "$(nv --headless +"lua io.write(tostring(vim.o.relativenumber))" +q)" = true ]' \
"relativenumber aktiv"
ok '[ -d ~/term-lab/state/nvim ]' "Lab-State statt ~/.local/state"
ok '[ "$(grep -c "^ - name: " hosts.txt)" -eq 4 ]' "Makro: 4 YAML-Einträge"
ok '[ "$(rg -c FIXME . | wc -l)" -eq 2 ]' "cdo: 2 Dateien mit FIXME"
ok '[ "$EDITOR" = nv ]' "EDITOR=nv"Erwartet:
✔ init.lua lädt fehlerfrei
✔ relativenumber aktiv
✔ Lab-State statt ~/.local/state
✔ Makro: 4 YAML-Einträge
✔ cdo: 2 Dateien mit FIXME
✔ EDITOR=nv
Challenge
Nummeriere die Zeilen der ursprünglichen Host-Liste zu
1. web-01 bis 4. cache-01 – ohne die Zahlen
einzeln zu tippen.
Hinweis: Erst überall 0. voranstellen,
dann im visuellen Modus gestaffelt hochzählen.
Lösung
git show HEAD:hosts.txt > nummern.txt
nv nummern.txt:%s/^/0. /<CR>
ggVG
g<C-a>
:w<CR>
cat nummern.txtErwartet:
1. web-01
2. web-02
3. db-01
4. cache-01
Alternative ohne visuellen Modus:
:%s/^/\=line('.') . '. '/ – \= wertet einen
Ausdruck aus.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Auf Servern gibt es oft nur
vi/vimohne deine Konfig. Die Motions aus diesem Tag funktionieren dort trotzdem. sudoedit dateistattsudo nvim datei: Der Editor läuft als du, nur das Schreiben passiert mit Root-Rechten.- Plugins pinnen:
vim.packschreibt eine Lockdatei (nvim-pack-lock.json) – mit in die Dotfiles (Tag 13). - Keine Secrets in Swap-/Undo-Dateien: für sensible Dateien
nvim -n(kein Swap) und:setlocal noundofile. - Teams standardisieren eher
.editorconfigals Editor-Konfigs. Neovim liest sie seit 0.9 von selbst.