Come aprire file .GRAPHQL su Linux
Per aprire file .GRAPHQL su Linux, apri il file con un editor di codice (ad esempio, Visual Studio Code o un editor di testo desktop) perché è testo normale.
Istruzioni passo passo
- Apri il file con un editor di codice (ad esempio, Visual Studio Code o un editor di testo desktop) perché è testo normale.
- Abilita il supporto GraphQL nell'editor (ad esempio, le estensioni VS Code GraphQL) per convalidare schema e operazioni.
Problemi comuni
Si apre come testo normale senza evidenziazione della sintassi
Alcuni editor non riconoscono automaticamente .graphql o non includono le funzionalità del linguaggio GraphQL per impostazione predefinita, quindi il file appare come testo non colorato e gli errori non vengono contrassegnati.
- Installa un'estensione del linguaggio GraphQL nel tuo editor (ad esempio, "GraphQL: Language Feature Support" o "Apollo GraphQL" per VS Code).
- Se il tuo editor lo supporta, associa l'estensione .graphql alla modalità linguaggio GraphQL.
Lo schema o la query mostra errori di analisi/convalida
I documenti GraphQL devono seguire la grammatica definita dalle specifiche GraphQL; Parentesi graffe mancanti, nomi non validi o una struttura SDL errata possono far sì che gli strumenti riportino errori di sintassi.
- Confronta il file con la definizione del linguaggio e SDL della specifica GraphQL e risolvi i problemi di sintassi (ad esempio, parentesi graffe non corrispondenti o definizioni di tipo non valide).
- Se stai modificando più file di schema, assicurati che i tuoi strumenti stiano caricando tutti i file .graphql rilevanti in modo che i tipi/direttive a cui si fa riferimento siano noti.
Gli strumenti dell'editor lamentano la mancanza della configurazione del progetto
Alcune estensioni dell'editor GraphQL si basano sul contesto del progetto (posizione dello schema, endpoint o rilevamento dei file) per fornire convalida e completamento automatico; senza tale contesto, le funzionalità potrebbero essere limitate o soggette a errori.
- Configura la tua estensione GraphQL in base alla sua documentazione in modo che possa individuare lo schema e le operazioni nel tuo progetto.
- Se utilizzi sia lo schema che le operazioni, mantienili in posizioni coerenti e assicurati che l'estensione sia impostata per eseguire la scansione di tali percorsi.
Nota di sicurezza
I file .graphql sono in genere solo testo e non contengono intrinsecamente codice eseguibile, ma fai attenzione agli strumenti GraphQL che caricano automaticamente schemi o recuperano metadati dagli endpoint: l'apertura di un progetto non attendibile potrebbe attivare richieste di rete a seconda delle impostazioni dell'estensione dell'editor.