Kontext

Codebase-Indexierung

Indexierung Ihrer Codebase

Um bessere und genauere Antworten zur Codebase mit @codebase oder Ctrl/⌘ Enter zu erhalten, können Sie Ihre Codebase indexieren. Im Hintergrund berechnet Cursor Embedding-Vektoren für jede Datei in Ihrer Codebase und verwendet diese Vektoren, um die Genauigkeit der Codebase-Antworten zu verbessern.

Ihr Codebase-Index bleibt automatisch mit den neuesten Änderungen in der Codebase synchronisiert.

Sie können den Status der Codebase-Indexierung unter Cursor-Einstellungen > Funktionen > Codebase-Indexierung überprüfen.

Erweiterte Einstellungen

Standardmäßig indexiert Cursor alle Dateien in Ihrer Codebase.

Sie können auch auf erweiterte Optionen zugreifen, indem Sie den Abschnitt Einstellungen anzeigen erweitern. Hier können Sie entscheiden, ob die automatische Indexierung für neue Repositorys aktiviert werden soll und konfigurieren, welche Dateien Cursor während der Repository-Indexierung zusätzlich zu den .gitignore-Einstellungen ignorieren soll.

Wenn Sie große Inhaltsdateien in Ihrem Projekt haben, die die KI definitiv nicht lesen muss, kann das Ignorieren dieser Dateien die Genauigkeit der Antworten verbessern.

KI-Regeln

Sie können benutzerdefinierte Anweisungen für Cursor hinzufügen, indem Sie den Abschnitt Regeln für KI unter Cursor-Einstellungen > Allgemein > Regeln für KI bearbeiten.

Diese benutzerdefinierten Anweisungen werden für Funktionen wie Cursor Chat und Ctrl/⌘ K verwendet.

.cursorrules

Für projektspezifische Anweisungen können Sie diese in einer .cursorrules-Datei im Stammverzeichnis Ihres Projekts hinterlegen.

Ähnlich wie der Abschnitt "Regeln für KI" werden die Anweisungen in der .cursorrules-Datei für Funktionen wie Cursor Chat und Ctrl/⌘ K verwendet.

@-Symbole

Grundlegende Verwendung

In den KI-Eingabefeldern von Cursor, wie z.B. Cmd K, Chat oder Terminal Cmd K, können Sie @-Symbole verwenden, indem Sie @ eingeben. Ein Popup-Menü mit Vorschlägen wird angezeigt, das automatisch basierend auf Ihrer Eingabe gefiltert wird, um nur die relevantesten Vorschläge anzuzeigen.

Tastenkürzel

Sie können mit den Pfeiltasten nach oben/unten durch die Vorschlagsliste navigieren. Sie können einen Vorschlag auswählen, indem Sie Enter drücken. Wenn der Vorschlag eine Kategorie ist, wie z.B. Files, werden die Vorschläge gefiltert, um nur die relevantesten Elemente in dieser Kategorie anzuzeigen.

Cmd K Tastenkürzel

Sie können mit den Pfeiltasten nach oben/unten durch die ausgewählte Cmd K @-Symbole-Liste navigieren und Enter verwenden, um ausgewählte Kontextelemente ein-/auszuklappen. Für Dateireferenzen können Sie Ctrl/⌘ M verwenden, um die Dateilesestrategie umzuschalten. Lesen Sie mehr über Dateilesestrategien hier.

@Files

@Files

In KI-Eingabefeldern wie Cursor Chat und Cmd K können Sie @Files verwenden, um auf gesamte Dateien zu verweisen. Wenn Sie nach dem @ weiter tippen, werden Ihre Dateisuchergebnisse nach der @Code-Strategie angezeigt.

Um sicherzustellen, dass Sie die richtige Datei referenzieren, zeigt Cursor eine Vorschau des Dateipfads an. Dies ist besonders nützlich, wenn Sie mehrere Dateien mit demselben Namen in verschiedenen Ordnern haben.

Lange Dateireferenzen im Chat

Wenn der Dateiinhalt im Chat von Cursor zu lang ist, wird Cursor die Datei in kleinere Abschnitte unterteilen und sie basierend auf der Relevanz für die Abfrage neu anordnen.

Cmd K Chunking-Strategie

Für Cmd K verwendet Cursor Dateireferenzen ebenfalls unterschiedlich, basierend auf der Inhaltslänge.

• auto
  • Wählt automatisch eine von drei Lesestrategien basierend auf der Dateigröße aus
• full file
  • Die gesamte Datei wird als Kontext verwendet.
• outline
  • Cursor analysiert die Gliederung der Datei und verwendet die Informationen als Kontext.
• chunks
  • Cursor unterteilt die Datei in kleinere Abschnitte und wählt den relevantesten aus.

Drag and Drop

Sie können auch Dateien aus der Hauptseitenleiste per Drag and Drop in den Chat oder Cmd K ziehen, um sie als Kontext hinzuzufügen.

@Folders

Aktuell wird @Folders nur im Cursor Chat unterstützt.

@Folders

Sie können auch ganze Ordner als Kontext in Cursor referenzieren. @Folders ist besonders nützlich für Long Context Chat, wenn Sie dem KI eine große Menge an Kontext bereitstellen möchten.

@Code

@Code

Um bestimmte Codeabschnitte zu referenzieren, können Sie das Symbol @Code verwenden.

Code-Vorschau

Ähnlich wie beim Symbol @Files zeigt Cursor eine Vorschau des Codeinhalts an, sodass Sie überprüfen können, ob Sie den richtigen Code referenzieren.

From Editor

Eine weitere Möglichkeit, Code-Snippets als Kontext hinzuzufügen, besteht darin, den gewünschten Code auszuwählen und auf "Add to Chat" (Strg/⌘ Umschalt L) oder "Add to Edit" (Strg/⌘ Umschalt K) zu klicken.

Diese Aktionen fügen das ausgewählte Code-Snippet in das Chat-Eingabefeld oder die aktive Cmd-K-Eingabeleiste ein.

Um den ausgewählten Code einem neuen Chat hinzuzufügen, können Sie Strg/⌘ L drücken.

@Docs

@Docs

Cursor verfügt über eine Reihe von Drittanbieter-Dokumentationen, die gecrawlt, indiziert und als Kontext bereitgestellt wurden. Sie können darauf mit dem Symbol @Docs zugreifen.

Benutzerdefinierte Dokumentation hinzufügen

Falls Sie benutzerdefinierte Dokumentation crawlen und indizieren möchten, die nicht bereits vorhanden ist, können Sie dies über @Docs > Add new doc tun. Nachdem Sie die URL der gewünschten Dokumentation eingefügt haben, erscheint folgendes Fenster:

Cursor wird die Dokumentation anschließend indizieren und lernen, sodass Sie sie wie andere Dokumentationen als Kontext verwenden können. Wenn Sie alle Unterseiten und Unterverzeichnisse indizieren möchten, stellen Sie sicher, dass Sie am Ende der URL einen Schrägstrich hinzufügen.

Benutzerdefinierte Dokumentation verwalten

Unter Cursor Settings > Features > Docs finden Sie die von Ihnen hinzugefügte Dokumentation. Hier können Sie Dokumentation bearbeiten, löschen oder neue hinzufügen.

@Git

Derzeit wird @Git nur im Cursor Chat unterstützt.

@Git

Im Cursor-Chat können Sie @Git verwenden, um Git-Commits, Diffs oder Pull Requests zu Ihrer Eingabeaufforderung hinzuzufügen.

Häufige Anwendungsfälle

Ein häufiger Anwendungsfall für @Git ist, die KI von Cursor Diffs scannen zu lassen, um potenzielle Fehler oder Probleme zu identifizieren, die durch den Diff verursacht werden könnten.

Sie können auch @Diff of Working State verwenden, um Commit-Nachrichten aus dem aktuellen Diff zu generieren.

@Codebase

@Codebase

Mit @Codebase durchläuft der Cursor Chat die folgenden Schritte, um die wichtigsten Code-Snippets zu finden:

• Sammeln: Durchsucht Ihre Codebasis, um wichtige Dateien/Codeblöcke zu finden
• Sortieren: Ordnet Kontextelemente nach Relevanz für die Abfrage neu
• Analysieren: Denkt über den Plan zur Verwendung des Kontexts nach
• Generieren: Erstellt eine Antwort

Eine weitere Möglichkeit, erweiterte Codebasis-Abfragen zu stellen, besteht darin, auf das Dropdown-Menü neben der Schaltfläche Ctrl/⌘ + Enter zu klicken und reranker für das Suchverhalten auszuwählen. Dies ist nur verfügbar, wenn @Codebase nicht verwendet wird, da @Codebase sonst Vorrang hat.

@Web

@Web

Mit @Web erstellt Cursor Suchanfragen basierend auf Ihrer angegebenen Abfrage und dem Kontext und durchsucht das Internet, um relevante Informationen als zusätzlichen Kontext zu finden.

Dies ist nützlich, um Cursor die neuesten Online-Informationen finden zu lassen oder um Cursor innerhalb von Sekunden mehrere Websites durchsuchen zu lassen, um die beste Antwort zu finden, ohne dass Benutzer manuell suchen müssen.

@Chat

Diese Funktion ist derzeit nur für Cmd K verfügbar.

@Chat

Sie können @Chat in Cmd K verwenden, um aktuelle Chat-Nachrichten als Kontext hinzuzufügen. Dies ist nützlich, wenn Sie eine KI-Konversation haben, die Sie auf die Bearbeitung oder Generierung von Code anwenden möchten.

@Definitions

Diese Funktion ist derzeit nur für Cmd K verfügbar.

@Definitions

Das Symbol @Definitions fügt alle nahegelegenen Definitionen als Kontext zu Cmd K hinzu.

Links einfügen

@https://your-link.com

Um Cursor anzuweisen, einen Link vor der Antwort zu besuchen, geben Sie @ ein und fügen dann den Link ein.

Links entfernen

Standardmäßig analysieren wir Links automatisch und konvertieren sie in @Links im Cursor-Chat. Wenn Sie Links lieber als einfachen Text haben möchten, klicken Sie auf den Link und dann auf Unlink.

Dateien ignorieren

Die .cursorignore-Datei ermöglicht es Ihnen, Dateien und Verzeichnisse von der Codebasis-Indizierung in Cursor auszuschließen.

Über .cursorignore

Um Dateien von der Codebasis-Indizierung auszuschließen, können Sie eine .cursorignore-Datei im Stammverzeichnis Ihres Projekts verwenden. Sie funktioniert auf die gleiche Weise wie die .gitignore-Datei von Git.

.cursorignore folgt den Regeln von .gitignore. Wenn Sie bereits eine .gitignore-Datei haben, werden Dateien standardmäßig ignoriert. Wenn Sie zusätzliche Dateien ignorieren möchten, können Sie diese der .cursorignore-Datei hinzufügen.

Weitere Informationen dazu finden Sie auf unserer Sicherheitsseite.

Chat- und Composer-Kontext

Aktuell können Cursor Chat und Composer auf alle Dateien in ihrem Kontext zugreifen, ohne dass die .cursorignore-Einstellungen berücksichtigt werden.

Weitere Informationen darüber, wie wir KI-Anfragen behandeln, finden Sie auf unserer Sicherheitsseite.

Beispiel für eine .cursorignore-Datei

Bestimmte Dateien ignorieren

# Ignore all files in the `dist` directory
dist/

# Ignore all `.log` files
*.log

# Ignore specific file `config.json`
config.json