Zum Inhalt springen
Trainingslager IT-Trainingslager

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 + w oder c + i".
  • Eine Zahl davor wiederholt: d3w. Der Punkt . wiederholt die letzte Änderung.
  • Die Konfiguration ist eine einzige init.lua von 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/nvim bleibt 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/nv

Erwartet:

#!/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; echo

Erwartet:

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 nvim Konfigurationen. Das legt aber ~/.config/lab an. 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: ciw schlägt fast immer dw + 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.py

Erwartet:

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.txt

Erwartet:

  - 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 a zeigt, 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 FIXME

Erwartet:

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; echo

Erwartet:

 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; echo

Erwartet (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.editor

Erwartet:

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 Buffer

Erwartet 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.txt

Erwartet:

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/vim ohne deine Konfig. Die Motions aus diesem Tag funktionieren dort trotzdem.
  • sudoedit datei statt sudo nvim datei: Der Editor läuft als du, nur das Schreiben passiert mit Root-Rechten.
  • Plugins pinnen: vim.pack schreibt 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 .editorconfig als Editor-Konfigs. Neovim liest sie seit 0.9 von selbst.