Serpl-Befehle

Umfassende Serpl-Terminal-UI-Befehle für projektweite Such- und Ersetzungsvorgänge.

Installation

Befehl	Beschreibung
cargo install serpl	Via Cargo installieren (Rust)
brew install serpl	Via Homebrew installieren (macOS)
nix-env -i serpl	Via Nix installieren
pacman -S serpl	Auf Arch Linux installieren
Von GitHub Releases herunterladen	Vorkompilierte Binärdateien verfügbar
serpl --version	Serpl-Version anzeigen

Grundlegende Verwendung

Befehl	Beschreibung
serpl	Serpl im aktuellen Verzeichnis starten
serpl --search-text "oldFunc"	Mit vorausgefülltem Suchbegriff starten
serpl --replace-text "newFunc"	Mit vorausgefülltem Ersatz starten
serpl --search-path ./src	In spezifischem Verzeichnis suchen
serpl --hidden	Versteckte Dateien in Suche einschließen
serpl --ignore-case	Groß-/Kleinschreibung-unabhängige Suche

Navigationstasten

Tastaturkürzel	Beschreibung
j	Nach unten in Ergebnisliste bewegen
k	Nach oben in Ergebnisliste bewegen
g	Zum ersten Ergebnis springen
G	Zum letzten Ergebnis springen
/	In Ergebnisliste suchen
Enter	Aktion auswählen/bestätigen
Escape	Abbrechen/zurückgehen
q	Serpl beenden

Modus-Umschalter

Tastaturkürzel	Beschreibung
Tab	Zwischen Such- und Ersatzfeldern wechseln
Ctrl + N	Zwischen Such- und Ersatzmodus umschalten
Ctrl + B	Hilfedialog öffnen
Ctrl + C	Anwendung beenden

Suchvorgänge

Tastaturkürzel	Beschreibung
Im Suchfeld eingeben	Live-Suche über alle Dateien
Ctrl + N	Suchmodus umschalten
Modus mit Groß-/Kleinschreibung	Exact-Case-Übereinstimmung
Modus ohne Groß-/Kleinschreibung	Groß-/Kleinschreibung ignorieren
Regex-Modus	Reguläre Ausdrücke verwenden
AST Grep-Modus	Strukturelle Code-Suche

Ersetzungsvorgänge

Tastaturkürzel	Beschreibung
Ctrl + O	Ersatz für ALLE Dateien verarbeiten
d	Ausgewählte Datei oder Zeile aus Ergebnissen löschen
Einfacher Ersatz	Alle Vorkommen direkt ersetzen
Groß-/Kleinschreibung beibehalten	Ursprüngliches Einrichtungsmuster beibehalten
AST Grep-Ersatz	Strukturelle Code-Ersetzung

Ersatz-Modi

Modus	Beschreibung
Simple	Direkter Text-Ersatz
Preserve Case	Passt Einrichtungsmuster des ursprünglichen Textes an
AST Grep	Syntax-Tree-aware Ersetzung

Such-Modi

Modus	Beschreibung
Fixed String	Literale Text-Übereinstimmung
Regex	Reguläre Ausdrücke-Übereinstimmung
AST Grep	Strukturelles Code-Muster-Matching

Dateivorgänge

Tastaturkürzel	Beschreibung
d	Datei/Zeile aus Ergebnissen entfernen (überspringen)
Ctrl + O	Ersetzungen auf alle verbleibenden Dateien anwenden
Änderungen pro Datei überprüfen	Vorschau vor Anwendung sehen
Undo ist nicht verfügbar	Änderungen sind dauerhaft—Git verwenden

Konfiguration

Einstellung	Beschreibung
~/.config/serpl/config.json	Konfigurationsdatei-Speicherort
Benutzerdefinierte Tastenkombinationen	Standard-Kurzbefehle überschreiben
Standard-Suchmodus	Bevorzugten Suchmodus festlegen
Standard-Ersatzmodus	Bevorzugten Ersatzmodus festlegen
Datei-Muster-Filter	Konfigurieren, welche Dateien eingeschlossen werden
Ignore-Muster	Konfigurieren, welche Dateien ausgeschlossen werden

Beispiel-Konfiguration

{
  "key_bindings": {
    "quit": "q",
    "navigate_up": "k",
    "navigate_down": "j",
    "go_to_top": "g",
    "go_to_bottom": "G",
    "delete": "d",
    "process_replace": "Ctrl+o",
    "toggle_help": "Ctrl+b",
    "search_in_list": "/"
  },
  "search_mode": "fixed_string",
  "replace_mode": "simple"
}

Allgemeine Arbeitsabläufe

Arbeitsablauf	Beschreibung
Variable umbenennen	Alten Namen suchen → Mit neuem Namen ersetzen
Importpfade aktualisieren	Alten Pfad suchen → Mit neuem Pfad ersetzen
API-Aufrufe migrieren	Veraltetes suchen → Mit neuem API ersetzen
Tippfehler im Projekt beheben	Falsche Schreibweise suchen → Mit Korrekt ersetzen
Config-Werte aktualisieren	Alten Wert suchen → Mit neuem Wert ersetzen

Integration mit Git

Arbeitsablauf	Beschreibung
git diff nach serpl	Alle durchgeführten Änderungen überprüfen
git stash vor serpl	Aktuelle Arbeit zuerst speichern
git checkout -- . zum Rückgängigmachen	Alle Änderungen verwerfen, falls erforderlich
In einem Branch arbeiten	Such-Ersatz-Änderungen isolieren
git add -p nach serpl	Änderungen selektiv inszenieren

Vergleich mit Alternativen

Feature	Serpl	sed	VS Code
Interaktive Vorschau	Ja	Nein	Ja
TUI-Schnittstelle	Ja	Nein	GUI
Groß-/Kleinschreibung beibehalten	Ja	Manuell	Ja
AST Grep	Ja	Nein	Erweiterung
Funktioniert über SSH	Ja	Ja	Nein
Regex-Unterstützung	Ja	Ja	Ja

Tipps und Best Practices

Tipp	Beschreibung
Immer Git verwenden	Vor Ersetzungen committen
Vor Anwendung Vorschau	Jede Änderung in der TUI überprüfen
AST Grep für Code verwenden	Strukturelles Matching vermeidet falsche Positive
Groß-/Kleinschreibung beibehalten verwenden	camelCase, PascalCase, etc. beibehalten
Falsche Positive entfernen	Mit d unerwünschte Übereinstimmungen überspringen
Spezifische Pfade suchen	Mit --search-path Umfang begrenzen
Versteckte Dateien überprüfen	Bei Bedarf --hidden Flag verwenden