Arbeiten mit großen Codebasen
Strategien für die Navigation und das Arbeiten mit großen Codebasen
Das Arbeiten mit großen Codebasen erfordert spezifische Strategien, um Kontextbeschränkungen zu bewältigen und die Produktivität aufrechtzuerhalten. Dieser Leitfaden bietet praktische Workflows, um große Projekte mit Verdent for VS Code effizient zu navigieren, zu verstehen und zu bearbeiten.
Verwenden des Explorer-Agenten zur Codebase-Erkundung
Angenommen, Sie sind neu in einer großen Codebase und müssen herausfinden, wo eine bestimmte Funktionalität implementiert ist.
Stellen Sie breite Erkundungsfragen
Where is user authentication handled in this codebase?Verdent delegiert automatisch an den Explorer-Agenten, einen tokeneffizienten Spezialisten für Codebase-Suchen.
Der Explorer sucht effizient
Der Explorer-Agent:
- Durchsucht Dateinamen und Pfade
- Durchsucht den Code-Inhalt nach Schlüsselwörtern
- Analysiert Architekturmuster
- Liefert Ergebnisse mit Dateipfaden und Code-Ausschnitten
Verfeinern Sie Ihre Suche
Show me all files that import the authentication moduleDer Explorer kann Folgesuchen durchführen, um die Ergebnisse einzugrenzen.
Parallelisieren Sie komplexe Suchen
Für eine umfassende Erkundung kann Verdent mehrere Explorer-Agenten parallel ausführen:
- Explorer 1: Findet die Authentifizierungslogik
- Explorer 2: Findet die Autorisierungslogik
- Explorer 3: Findet die Sitzungsverwaltung
Durch die parallele Suche treffen die Ergebnisse schneller ein.
Tipps:
- Der Explorer-Agent arbeitet in großen Codebasen effizient, ohne den Hauptkontext zu füllen
- Mehrere Explorer-Agenten können verschiedene Aspekte gleichzeitig durchsuchen
- Nutzen Sie den Explorer für Musterabgleich und Architekturerkundung
- Die Ergebnisse enthalten Dateipfade und relevante Code-Ausschnitte für den Kontext
Aufgaben in überschaubare Abschnitte unterteilen
Angenommen, Sie arbeiten an einer großen Codebase und müssen eine Funktion hinzufügen, die viele Dateien betrifft.
Identifizieren Sie natürliche Aufgabengrenzen
Statt alles auf einmal anzufordern:
Phase 1: Add the data models for the notification systemKonzentrieren Sie sich zunächst auf eine einzelne, in sich geschlossene Komponente.
Schließen Sie die Phase vollständig ab
Arbeiten Sie Phase 1 vollständig durch, einschließlich Tests, bevor Sie zu Phase 2 übergehen. So entsteht ein klarer Kontrollpunkt.
Committen Sie Ihren Fortschritt
git add .
git commit -m "feat: add notification data models"Ein Commit schafft einen sicheren Rückfallpunkt.
Leeren Sie den Kontext für die nächste Phase
Bei komplexen Aufgaben sollten Sie den Kontext leeren, bevor Sie zur nächsten Phase übergehen. So stellen Sie sicher, dass Verdent genügend Kontextkapazität hat, um die Spitzenleistung zu erhalten.
Phase 2: Build the notification API endpoints using the data modelsStarten Sie eine neue Sitzung mit frischem Kontext, der sich ausschließlich auf Phase 2 konzentriert.
Tipps:
- Natürliche Unterbrechungspunkte verhindern eine Erschöpfung des Kontexts
- Jede Phase sollte unabhängig testbar sein
- Commits zwischen den Phasen ermöglichen sicheres Experimentieren
- Neue Sitzungen halten den Kontext übersichtlich und fokussiert
Plan Mode für umfangreiche Änderungen nutzen
Angenommen, Sie müssen eine Funktion refaktorieren, die sich über Dutzende von Dateien in einer großen Codebase verteilt.
Beginnen Sie im Plan Mode
Switch to Plan Mode: Refactor the payment processing logic to use a new payment provider across all filesPlan Mode ermöglicht eine reine Leseanalyse, ohne dass Kontext für Dateiänderungen verbraucht wird.
Nutzen Sie den Explorer, um alle betroffenen Dateien zu finden
Use the Explorer agent to find all files that reference payment processingStellt sicher, dass jeder Ort erkannt wird, der aktualisiert werden muss.
Überprüfen Sie den umfassenden Plan
Verdent präsentiert einen Plan, der Folgendes zeigt:
- Alle Dateien, die Änderungen erfordern (25 Dateien identifiziert)
- Die minimale Menge an Dateien, die in den Hauptkontext aufgenommen werden sollen
- Die Reihenfolge der Arbeitsschritte
- Abhängigkeiten zwischen den Änderungen
Prüfen Sie den Plan, bevor Sie sich für diesen Ansatz entscheiden.
Ausführung genehmigen
Sobald Sie mit dem Plan zufrieden sind, genehmigen Sie die Ausführung. Verdent arbeitet die Änderungen methodisch ab.
Tipps:
- Plan Mode hilft, minimale Dateimengen vor der Ausführung zu identifizieren
- Der Explorer stellt sicher, dass bei umfangreichen Refactorings keine Dateien übersehen werden
- Pläne zeigen den Umfang deutlich, bevor Kontext verbraucht wird
- Speichern Sie Pläne in Dateien zur Dokumentation und Team-Überprüfung
Koordinierte Änderungen über viele Dateien hinweg vornehmen
Angenommen, Sie müssen eine Funktion umbenennen, die in mehr als 50 Dateien einer großen Codebase verwendet wird.
Nutzen Sie den Explorer, um alle Verwendungen zu finden
Use the Explorer agent to find all files that use the calculateTotal functionIdentifiziert jede Datei, die aktualisiert werden muss.
Überprüfen Sie den Umfang im Plan Mode
In Plan Mode: Rename calculateTotal to computeFinalTotal across all filesSehen Sie sich den vollständigen Umfang an, bevor Sie Änderungen vornehmen.
Stellen Sie sicher, dass keine Dateien übersehen werden
Verdent zeigt alle 52 Dateien an, die aktualisiert werden müssen. Prüfen Sie die Liste auf Vollständigkeit.
Koordinierte Änderungen ausführen
Genehmigen Sie den Plan. Verdent aktualisiert alle Dateien systematisch und stellt eine konsistente Umbenennung überall sicher.
Führen Sie Tests zur Überprüfung durch
Run the full test suite to verify all references were updated correctlyTests erfassen alle übersehenen Referenzen.
Tipps:
- Der Explorer stellt sicher, dass bei umfangreichen Änderungen keine Dateien übersehen werden
- Plan Mode zeigt den vollständigen Umfang vor der Ausführung
- Systematische Aktualisierungen erhalten die Konsistenz über alle Dateien hinweg
- Testen Sie umfassend nach umfangreichen Refactorings
Koordinierte Änderungen über viele Dateien hinweg sind in Phasen sicherer: Aktualisieren Sie eine Ebene, überprüfen Sie sie, und fahren Sie dann mit den abhängigen Ebenen fort.
Häufig gestellte Fragen
Wie erkenne ich, dass ich mich den Kontextgrenzen nähere?
Anzeichen sind langsamere Antwortzeiten, Sitzungen, die mehrere Stunden laufen, oder viele geladene große Dateien. Beobachten Sie die Dauer Ihrer Sitzung und die Anzahl der Dateien. Wenn Sie eine Leistungsverschlechterung feststellen, schließen Sie Ihre aktuelle Aufgabe ab, committen Sie Ihren Fortschritt und starten Sie eine neue Sitzung mit sauberem Kontext.
Ist es sicher, Verdent Dutzende von Dateien gleichzeitig ändern zu lassen?
Ja, bei richtiger Anwendung. Nutzen Sie immer Plan Mode, um zunächst den vollständigen Umfang zu überprüfen, stellen Sie eine umfassende Testabdeckung sicher und committen Sie häufig zwischen den Phasen. So können Sie Änderungen schrittweise überprüfen und bei Bedarf leicht zurücksetzen.
Wann sollte ich den Explorer-Agenten verwenden statt Dateien direkt zu laden?
Verwenden Sie den Explorer-Agenten für Erkundungs- und Suchaufgaben, ohne den Hauptkontext zu verbrauchen. Laden Sie Dateien nur dann direkt über @-Erwähnungen, wenn Sie sie bearbeiten müssen. Der Explorer ist ideal für Fragen wie „Finde alle Dateien, die...", während @-Erwähnungen für Aufgaben wie „Aktualisiere diese bestimmte Datei" gedacht sind.
Welche Modell-Voreinstellung ist für die Arbeit mit großen Codebasen am besten geeignet?
Verwenden Sie die Voreinstellung Performance für komplexe, dateiübergreifende Operationen und Refactorings. Verwenden Sie die Voreinstellung Efficiency für einfache Suchen und Erkundungsaufgaben. Performance bietet mehr Reasoning-Fähigkeiten für koordinierte Änderungen, während Efficiency für die Erkundung schneller und kostengünstiger ist.