Suchen
Free & PremiumDas Fenster Suchen (In Dateien suchen) findet Text in vielen Dateien gleichzeitig und ersetzt ihn auf Wunsch. Es sucht schon beim Tippen, gruppiert die Treffer nach Ordner und Datei und zeigt rechts eine Vorschau mit der Fundstelle. Auch Dateien, deren Name zur Suche passt, stehen in der Liste, etwa eine neue, noch leere Datei.
Was du hier machst
- Wo gesucht wird: Projekt, Ordner, offene Dateien, Git-Änderungen, eigene Bereiche, Dateimaske
- Ersetzen: in einer Datei oder in allen Treffern, mit Rückgängig
- Auf einem Server: in einem Ordner einer Verbindung suchen (Premium)
So suchst du
- Drücke ⇧⌘F (oder Bearbeiten ▸ In Dateien suchen). Ab Werk öffnet sich ein schwebendes Fenster über der Codefläche.
- Tippe den Suchbegriff. Die Treffer erscheinen nach kurzer Pause, gruppiert nach Ordner, Datei und Zeile. Eine Statuszeile über der Liste nennt Treffer, Dateien und die Dauer, dazu die Zahl der passenden Dateinamen.
- Wähle einen Treffer mit ↑ ↓ (mit ⌥ von Datei zu Datei). Rechts zeigt die Vorschau die Stelle in der Datei.
- ↩ öffnet den Treffer im Editor, ⌘↩ in einer Teilung daneben. Esc schließt das Fenster.
Aufbau der Seite
Suchfeld mit den Schaltern:
| Schalter | Wirkung |
|---|---|
| Groß-/Kleinschreibung beachten | findet nur genau diese Schreibweise |
| Ganzes Wort | findet den Begriff nicht als Teil eines längeren Wortes |
| Regulärer Ausdruck | Suche mit Regex. Ein ungültiger Ausdruck wird als Text gesucht, die Statuszeile sagt es. |
| Mehrzeilig | Regex: . trifft auch Zeilenumbrüche; Text: \n steht für einen Zeilenumbruch |
| Unscharf | ein Tippfehler pro Wort ab fünf Zeichen ist erlaubt |
| Filter hinzufügen | Filter als Chip ins Suchfeld, siehe unten |
| Verlauf (⌃↓) | die letzten 50 Suchen samt Optionen |
| Favoriten | Als Favorit speichern … legt die aktuelle Suche unter einem Namen ab |
| Ersetzen (⇧⌘R) | blendet das Feld zum Ersetzen ein, siehe Ersetzen |
Bereichszeile darunter: Projekt, Ordner, Offene Dateien und Mehr, das Kästchen Ignorierte Ordner und die Dateimaske, siehe Wo gesucht wird.
Ergebnisliste links, Vorschau rechts. In der Vorschau zeigt Ganze Datei zeigen die ganze Datei statt nur der Trefferbereiche, Im Split öffnen und Öffnen öffnen sie.
Filter im Suchfeld
Direkt tippen oder über Filter hinzufügen:
| Filter | Bedeutung |
|---|---|
ext:php |
Dateiendung |
path:src |
Pfad enthält |
-path:vendor |
Pfad ausschließen |
size:<1mb |
Kleiner als 1 MB |
changed:7d |
In den letzten 7 Tagen geändert |
git:modified, git:staged |
Nur Git-geänderte Dateien, Nur gestagte Dateien |
foo AND bar |
beide Begriffe in derselben Datei, bis zu acht Begriffe |
"…" |
Exakte Phrase |
Ein Filter wird zum Chip. Doppelklick bearbeitet ihn, ⌫ am Anfang des Feldes entfernt den letzten.
Nach der Suche
Unter dem Suchfeld grenzen Knöpfe das Ergebnis weiter ein, ohne neu zu suchen: je Dateiendung (Nur .php …), Nur Projektcode (ohne vendor und node_modules) und … ausgeblendet · zeigen, wenn du Dateien oder Ordner ausgeblendet hast. Ausblenden geht per Rechtsklick auf einen Treffer (Datei ausblenden, Ordner … ausblenden). Nach Ordnern gruppieren und Flache Liste wechseln die Darstellung.
Ergebnis anheften
Ergebnis als Tab anheften macht aus der Trefferliste einen Tab. Dort hakst du Treffer mit der Leertaste als erledigt ab, siehst den Fortschritt („3 von 12 erledigt“), blendest Erledigte aus und suchst mit Neu suchen erneut. Das hilft bei Aufräumarbeiten über viele Dateien.
Schwebend oder angedockt
Im schwebenden Fenster dockt Als Werkzeugfenster andocken die Suche ins untere Dock. Angedockt macht Als schwebendes Fenster sie wieder schwebend. ⇧⌘F öffnet die Suche danach immer so, wie du sie zuletzt hattest.
Free und Premium
Die Suche auf deinem Mac ist frei. Die Suche in einem Ordner auf einem Server gehört zu Premium.
Einstellungen dazu stehen unter Einstellungen › Suche, siehe Suche: Standard-Ausschlüsse, .gitignore, versteckte Dateien, Größen- und Trefferlimit, Live-Suche, Gruppierung und Verlauf.
Wo gesucht wird Free
Die Zeile unter dem Suchfeld legt fest, welche Dateien die Suche durchgeht: das ganze Projekt, einen Ordner, die offenen Dateien, nur Git-Änderungen, einen Ordner irgendwo auf dem Mac oder einen eigenen, gespeicherten Bereich. Mit der Dateimaske grenzt du zusätzlich auf Dateitypen ein, und das Kästchen Ignorierte Ordner nimmt sonst ausgelassene Ordner wie vendor dazu.
So findest du es
Öffne die Suche mit ⇧⌘F. Die Bereichszeile steht direkt unter dem Suchfeld. Aus dem Projektbaum kommst du mit Rechtsklick auf einen Ordner ▸ In Ordner suchen … direkt in den Bereich dieses Ordners.
Die Bereiche
| Bereich | Was durchsucht wird |
|---|---|
| Projekt | der Projektordner und alle angehängten Ordner |
| Ordner | ein Ordner deiner Wahl. Ein Klick öffnet den Finder-Dialog, danach heißt der Knopf Ordner: Name. Mit In Ordner suchen … im Projektbaum ist der Ordner schon gesetzt. |
| Offene Dateien | die Dateien, die als Tab offen sind. Ausgegraut, wenn keine offen ist. |
Unter Mehr stehen:
- Angehängte Ordner: nur die angehängten Ordner, ohne das Hauptprojekt
- Git: geänderte Dateien und Git: gestagte Dateien
- Ordner auf dem Mac: ein beliebiger Ordner, auch außerhalb des Projekts. Ordner auf dem Mac wählen … wählt einen anderen.
- Server, mit Premium:
server:/pfadmit dem Namen der Verbindung, siehe Auf einem Server - deine eigenen Bereiche
- Bereich speichern … und Bereich löschen ▸
Nicht verfügbare Bereiche (etwa ohne angehängte Ordner) sind ausgegraut. Den gewählten Bereich merkt sich der Editor je Projekt.
So gehst du vor
Einen eigenen Bereich speichern
- Mehr ▸ Bereich speichern …
- Gib einen Name ein, zum Beispiel „Storefront-Templates“.
- Gib die Muster, relativ zum Projekt ein, mehrere durch Leerzeichen getrennt, zum Beispiel
custom/plugins/*/src/Resources/views/** !**/admin/**.!musterschließt aus. - Der Bereich steht danach unter Mehr und gilt für dieses Projekt. Bereich löschen ▸ entfernt ihn wieder.
Mit der Dateimaske eingrenzen
Die Dateimaske rechts in der Bereichszeile filtert nach Dateinamen:
*.css, *.phpsucht nur in diesen Dateien. Komma trennt die Muster.test.cssfindet diese Datei in jedem Ordner.!*.min.jsschließt aus.src/**/*.tsfiltert nach Pfaden.
Das Kästchen vor dem Feld schaltet die Maske ein und aus, sie bleibt dabei erhalten. Der Pfeil im Feld zeigt Vorschläge: Zuletzt benutzt, Im Projekt (die häufigsten Endungen) und In den Treffern. Findet eine Suche mit Maske nichts, bietet die Statuszeile an, ohne Dateimaske zu suchen.
Was draußen bleibt
Ab Werk lässt die Suche aus:
- die Standard-Ausschlüsse:
node_modules,vendor,var/cache,.idea,*.min.js,*.min.css,*.map - was
.gitignoreausschließt (.gitignore beachten) - Binärdateien und Dateien über 5 MB
Das Kästchen Ignorierte Ordner nimmt für diese Suche auch node_modules, vendor, .git, Build-Ordner (dist, build …) und alles aus .gitignore dazu. Die Vorgaben stellst du unter Einstellungen › Suche ein (Suche). Versteckte Dateien wie .env und .htaccess durchsucht der Editor ab Werk mit.
Auch Dateinamen
Die Suche listet auch Dateien, deren Name jeden Suchbegriff enthält, selbst wenn im Inhalt nichts passt: leere, binäre und große Dateien eingeschlossen. Sie tragen den Hinweis Dateiname, die Statuszeile zählt sie (Dateinamen: …). Bereich, Dateimaske, Ausschlüsse und .gitignore gelten auch hier, höchstens 1.000 Dateien je Suche. Auf einem Server gibt es das nicht.
Umlaute findet die Suche in beiden Unicode-Formen. Ein getipptes „ü“ trifft also auch Text, den macOS zerlegt gespeichert hat, etwa in kopierten Dateinamen.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
Treffer in vendor fehlen |
Standard-Ausschluss | Ignorierte Ordner anhaken |
| Dieser Bereich ist gerade nicht verfügbar | Es gibt zum Beispiel keine offenen Dateien oder keine angehängten Ordner. | anderen Bereich wählen |
| Der Ordner existiert nicht mehr | Der gewählte Ordner wurde gelöscht oder verschoben. | Ordner neu wählen |
| Ungültiges Dateimuster | Die Maske enthält ein Muster, das so nicht geht. | Maske korrigieren |
Siehe auch
Ersetzen Free
Das Suchfenster ersetzt Treffer in einer Datei oder in allen Dateien des Bereichs. Vor dem Ersetzen siehst du jede Stelle, hakst einzelne ab und kannst alles mit einem Klick rückgängig machen. Jeder alte Stand landet vorher in der lokalen Historie.
So findest du es
- ⇧⌘R (Bearbeiten ▸ In Dateien ersetzen) öffnet die Suche mit dem Feld zum Ersetzen.
- Im offenen Suchfenster der Schalter Ersetzen (⇧⌘R).
So gehst du vor
- Drücke ⇧⌘R und gib oben den Suchbegriff ein.
- Gib im Feld Ersetzen durch … den neuen Text ein. Mit Regulärer Ausdruck setzt du Gruppen mit
$1,$2ein. - Prüfe die Treffer. Die Liste und die Vorschau zeigen, was an jeder Stelle stehen wird. Das Kästchen Diese Stelle ersetzen an Treffern, Dateien und Ordnern nimmt einzelne Stellen heraus oder wieder dazu.
- Ersetze:
- In dieser Datei: nur in der Datei der Vorschau.
- Alle ersetzen (⌘↩ im Feld): alle angehakten Stellen.
- Danach meldet die Statuszeile, wie viele Stellen in wie vielen Dateien ersetzt wurden. Rückgängig daneben holt alle alten Stände zurück.
Optionen
| Option | Bedeutung |
|---|---|
| Schreibweise erhalten | passt die Schreibweise an jede Stelle an: foo wird bar, Foo wird Bar, FOO wird BAR |
| Regulärer Ausdruck | $1 und weitere für Gruppen |
| Groß-/Kleinschreibung beachten, Ganzes Wort | gelten auch beim Ersetzen |
Was im Hintergrund passiert
- Ab einer einstellbaren Zahl von Dateien fragt der Editor vorher „In … Dateien ersetzen?“ und nennt die Zahl der Stellen. Ab Werk ab 50 Dateien (Einstellungen › Suche › Rückfrage beim Ersetzen ab).
- Vor dem Schreiben legt der Editor den alten Stand jeder Datei in der lokalen Historie ab. Rückgängig setzt alles zurück. Dateien, die du seitdem bearbeitet hast, lässt es, wie sie sind.
- Übersprungen werden Dateien, die größer als 2 MB, schreibgeschützt oder Binärdateien sind, deren Kodierung unklar ist, in denen ungespeicherte Änderungen im Editor stehen oder die sich seit der Suche geändert haben. Die Statuszeile nennt die Zahl, der Tooltip die Dateien und Gründe.
Wo Ersetzen nicht geht
Ersetzen geht nur mit einem Suchbegriff und in lokalen Bereichen. Auf einem Server gibt es kein Ersetzen. Steht der Bereich auf einem Server, sagt das Fenster es unter dem Feld.
Wenn es nicht klappt
| Was du siehst | Was du tust |
|---|---|
| … Dateien übersprungen | Tooltip lesen. Ungespeicherte Dateien speichern, dann noch einmal suchen und ersetzen. |
| inzwischen geändert, bitte neu suchen | neu suchen, dann ersetzen |
| Zeichen passen nicht in die Kodierung | Die neue Zeichenfolge lässt sich in der Kodierung der Datei nicht speichern, etwa Emoji in Latin-1. Datei in UTF-8 umstellen. |
Siehe auch
Auf einem Server Premium
Mit Premium sucht das Suchfenster auch in einem Ordner auf einem Server, über eine Verbindung aus dem Remote-Fenster. Gesucht wird auf dem Server selbst, mit rg oder grep. Die Dateien werden dafür nicht heruntergeladen. Bevor eine Suche startet, prüft der Editor die Last des Servers, damit eine Suche eine laufende Website nicht ausbremst.
So findest du es
- Im Serverbaum: Rechtsklick auf einen Ordner ▸ In Ordner suchen …. Das Suchfenster öffnet sich mit diesem Ordner als Bereich.
- Im Suchfenster unter Mehr: jeder Server, mit dem du verbunden bist oder in dem du in diesem Projekt schon gesucht hast, als
server:/pfadmit dem Namen der Verbindung. - Im Suchfeld: Tippe
server:/var/www/shop(mit Leerzeichen am Ende). Das wird zum Bereich dieses Ordners auf dem Server, der gerade offen ist.~steht für den Home-Ordner.
So gehst du vor
- Rechtsklick auf den Ordner im Serverbaum ▸ In Ordner suchen ….
- Tippe den Suchbegriff.
- Drücke ↩. Auf einem Server sucht der Editor nie schon beim Tippen.
- Die Treffer erscheinen wie bei einer lokalen Suche. ↩ öffnet einen Treffer als Serverdatei mit Arbeitskopie (siehe Dateien auf dem Server).
Den Ordner je Server merkt sich der Editor für dieses Projekt.
Last und Grenzen
- Vor jeder Suche prüft der Editor die Last des Servers. Liegt sie über deiner Grenze, fragt er Der Server ist ausgelastet und nennt Last und Zahl der Kerne.
- Wählst du
/oder einen Ordner mit einem sehr großen Baum (etwa den Home-Ordner eines Hosters), fragt er Ganz … durchsuchen? und rät zu einem Projektordner. - Trotzdem suchen erlaubt genau das für eine Minute.
- Auf einem Server läuft immer nur eine Suche zur Zeit.
- Bei der Treffergrenze hört die Suche auf und beendet den Prozess auf dem Server.
- Ersetzen, Unscharf und Mehrzeilig gibt es auf dem Server nicht, die Schalter sind ausgegraut. Dateinamen als Treffer gibt es dort ebenfalls nicht.
Einstellungen
Unter Einstellungen › Remote, Gruppe Suche auf dem Server (Remote):
| Einstellung | Bedeutung | Ab Werk |
|---|---|---|
| Auf dem Server auslassen | Ordner und Muster, die eine Server-Suche nie durchläuft. Ein Name meint jeden Ordner dieses Namens, ein Pfad wie var/cache diesen Ordner in jeder Tiefe. |
.git, node_modules, vendor, var/cache, var/log, public/media, public/thumbnail, files |
| Nachfragen ab einer Last von | Liegt die Last über diesem Wert mal der Zahl der Kerne, fragt der Editor vorher. | 0,8 |
| Treffergrenze | höchstens so viele Treffer, maximal 2000 | 2000 |
Das Kästchen Ignorierte Ordner im Suchfenster nimmt vendor und node_modules auch auf dem Server wieder dazu.
Dateinamen auf einem Server findest du mit Überall suchen (⇧⇧) im Reiter Server.
Free und Premium
Die Suche auf einem Server gehört zu Premium.
Wenn es nicht klappt
| Was du siehst | Was du tust |
|---|---|
| Server ausgelastet (nicht gesucht) | später suchen oder Trotzdem suchen |
| Auf diesem Server läuft schon eine Suche | warten, bis sie fertig ist |
| Diesen Ordner gibt es auf dem Server nicht | Ordner prüfen, im Serverbaum neu wählen |
| Server-Pfade beginnen mit / oder ~ | den Pfad nach server: korrigieren |
| Der Server hat auf die Prüfung vor der Suche nicht geantwortet | Verbindung prüfen, neu verbinden |
| Dieser Modus geht auf einem Server nicht | Unscharf und Mehrzeilig ausschalten |