Glob-Muster Referenz

Visual Studio Code verwendet Glob-Muster in vielen Komponenten. Beispiele hierfür sind die Einstellung von Datei- und Ordner-Includes/Excludes in Funktionen wie der Suche, das Ausblenden von Dateien im Datei-Explorer oder das Markieren von Dateien als schreibgeschützt und das Einrichten von sprachspezifischen Dateizuordnungen.

Glob-Muster-Syntax

VS Code unterstützt die folgende Glob-Syntax

• / zur Trennung von Pfadsegmenten
• * um null oder mehr Zeichen in einem Pfadsegment abzugleichen
• ? um ein einzelnes Zeichen in einem Pfadsegment abzugleichen
• ** um eine beliebige Anzahl von Pfadsegmenten abzugleichen, auch null
• {} zur Gruppierung von Bedingungen (z. B. {**/*.html,**/*.txt} passt auf alle HTML- und Textdateien)
• [] zum **Deklarieren** eines Zeichensatzbereichs, der übereinstimmen soll (example.[0-9] passt auf example.0, example.1, …)
• [!...] zum Negieren eines Zeichensatzbereichs, der übereinstimmen soll (example.[!0-9] passt auf example.a, example.b, aber nicht auf example.0)

Hinweis: Pfade werden durch / und nicht durch \ getrennt, auch unter Windows. Glob-Muster passen jedoch sowohl auf Pfade mit Schräg- als auch mit Rückschrägstrichen.

Sonderfälle

Glob-Muster in der Suchansicht funktionieren anders als in Einstellungen wie files.exclude und search.exclude. In den Einstellungen müssen Sie **/example verwenden, um einen Ordner namens example im Unterordner folder1/example in Ihrem Arbeitsbereich abzugleichen. In der Suchansicht wird das Präfix ** angenommen. Glob-Muster in diesen Einstellungen werden immer relativ zum Pfad des Arbeitsbereichsordners ausgewertet.

Häufig gestellte Fragen

Warum unterstützen Glob-Muster nicht Funktion X oder Y?

Wir haben unsere eigene Glob-Matching-Bibliothek mit dem Ziel implementiert, optimale Leistung für die meisten typischen Muster zu bieten. Wenn Sie erwarten, dass eine bestimmte Glob-Syntax unterstützt wird, können Sie ein Problem mit Ihrem Anwendungsfall melden.

Warum funktioniert mein Glob-Muster nicht?

Stellen Sie unter Windows sicher, dass Sie / zur Trennung von Pfaden verwenden und nicht \. Glob-Muster in VS Code erfordern / zur Trennung von Pfaden, passen aber sowohl auf / als auch auf \ in Pfaden.

Wenn Sie versuchen, ein Sonderzeichen wie [ oder ] buchstäblich abzugleichen, maskieren Sie es, indem Sie das Sonderzeichen in eckige Klammern (einzelnes Zeichenbereich) setzen, damit es nicht beim Mustervergleich interpretiert wird. Rückschrägstriche maskieren sie nicht. Um beispielsweise Dateien unter src/routes/post/[id]/ abzugleichen, würden Sie das Muster src/routes/post/[[]id[]]/** verwenden.