So öffnen Sie .GQL-Dateien unter Mac
Um .GQL-Dateien unter Mac zu öffnen, klicken Sie bei gedrückter Strg-Taste auf die .gql-Datei → Öffnen mit → wählen Sie einen Text-/Code-Editor (jeder Nur-Text-Editor funktioniert).
Schritt-für-Schritt-Anleitung
- Klicken Sie bei gedrückter Strg-Taste auf die .gql-Datei → Öffnen mit → wählen Sie einen Text-/Code-Editor (jeder Nur-Text-Editor funktioniert).
- Aktivieren Sie zur Vervollständigung/Validierung die GraphQL-Sprachtools in Ihrem Editor, die .gql-Dateien unterstützen.
Häufige Probleme
Die Datei wird als einfacher Text ohne GraphQL-Hervorhebung oder Validierung geöffnet
Viele Editoren behandeln .gql als generischen Text, es sei denn, die GraphQL-Sprachtools sind installiert oder so konfiguriert, dass sie .gql als erkannte Erweiterung enthalten.
- Installieren/aktivieren Sie die GraphQL-Sprachtools in Ihrem Editor (GraphQL-Sprachdienst/Plugin).
- Überprüfen Sie die Einstellungen des Tools auf erkannte Dateierweiterungen und stellen Sie sicher, dass .gql enthalten ist.
Build- oder Codegenerierungstools ignorieren .gql-Dateien
Einige Toolchains sind so konfiguriert, dass sie nur bestimmte Erweiterungen (häufig .graphql) nach GraphQL-Dokumenten scannen.
- Überprüfen Sie die Konfiguration Ihres Tools auf enthaltene Dokument-Globs/Erweiterungen und fügen Sie bei Bedarf *.gql hinzu.
- Wenn das Tool nicht konfiguriert werden kann, benennen Sie die Datei in eine gescannte Erweiterung um (normalerweise .graphql), während der Inhalt unverändert bleibt.
Anforderungen schlagen zur Laufzeit fehl, da das GQL-Dokument für das Serverschema nicht gültig ist
Eine .gql-Datei kann syntaktisch gültiges GraphQL sein, aber dennoch bei einem bestimmten Schema fehlschlagen (fehlende Felder, falsche Argumente oder Nichtübereinstimmung der Fragmenttypen).
- Validieren Sie das Dokument mit schemafähigen Tools (GraphQL-Sprachdienst/IDE-Integration) anhand des richtigen Schemas.
- Aktualisieren Sie den Vorgang/die Fragmente so, dass sie mit dem Serverschema übereinstimmen, und versuchen Sie es erneut.
Sicherheitshinweis
.gql-Dateien sind reine GraphQL-Textdokumente, keine ausführbaren Dateien. Sie können jedoch immer noch den Zugriff auf sensible Daten vorantreiben, wenn sie als Operationen für einen GraphQL-Endpunkt verwendet werden (z. B. versehentliches Festschreiben privater Abfragen oder interner Fragmente).