.GQL estensione file
Per aprire file .GQL su Windows, fai clic con il pulsante destro del mouse sul file .gql → Apri con → scegli un editor di testo/codice (qualsiasi editor in grado di aprire testo semplice).
Per aprire un file .gql, utilizza un editor di codice in testo semplice (ad esempio VS Code o qualsiasi editor che già utilizzi). Se desideri evidenziare e convalidare la sintassi, abilita un plug-in di linguaggio GraphQL o un servizio di linguaggio GraphQL che riconosca l'estensione .gql.
Ultimo aggiornamento: 12 giugno 2026
Apri sul tuo dispositivo
Scegli il tuo sistema operativo per una guida passo passo dedicata.
Come aprire file .GQL
Usa queste istruzioni specifiche per piattaforma per aprire file .GQL in modo sicuro.
Windows
- Fai clic con il pulsante destro del mouse sul file .gql → Apri con → scegli un editor di testo/codice (qualsiasi editor in grado di aprire testo semplice).
- Se desideri il supporto della sintassi GraphQL, abilita un plug-in o un servizio linguistico GraphQL nel tuo editor e assicurati che sia configurato per riconoscere l'estensione .gql.
Mac
- Fai clic tenendo premuto il tasto Control sul file .gql → Apri con → scegli un editor di testo/codice (funziona qualsiasi editor di testo semplice).
- Per il completamento/convalida, abilita gli strumenti del linguaggio GraphQL nel tuo editor che supporta i file .gql.
Linux
- Apri il file .gql in un editor di testo (ad esempio, l'editor di testo predefinito del tuo desktop o un editor di codice).
- Se utilizzi strumenti basati su LSP, configura/abilita il servizio linguistico GraphQL in modo che .gql venga trattato come un documento GraphQL.
iOS
- Apri il file .gql in un'app di editor di testo in grado di visualizzare testo semplice; per gli strumenti GraphQL completi, trasferisci il file su un editor desktop con supporto per il linguaggio GraphQL.
Android
- Apri il file .gql in un'app di editor di testo in grado di visualizzare testo semplice; per funzionalità di convalida e di riconoscimento dello schema, utilizza un editor di codice desktop con strumenti del linguaggio GraphQL.
Note di sicurezza
- I file .gql sono documenti GraphQL di testo semplice, non eseguibili; tuttavia, possono comunque favorire l'accesso a dati sensibili se utilizzati come operazioni su un endpoint GraphQL (ad esempio, eseguendo accidentalmente il commit di query private o frammenti interni).
- Prestare attenzione quando si aprono file .gql da fonti non attendibili in strumenti complessi (IDE, server linguistici, generatori di codice). Mentre il file è di testo, le vulnerabilità del parser o degli strumenti possono essere attivate da input non corretti.
- Se utilizzi query persistenti o invii file .gql con un'app, trattali come parte della tua superficie API: evita di incorporare segreti o dare per scontato che il documento rimarrà privato una volta distribuito.
Prima di eseguire codice scaricato
Questi file di solito richiedono un runtime (Python, Node, Java, …). Non sono i classici “virus da file”, ma codice non attendibile può comunque fare molti danni se lo esegui. Preferisci pacchetti ufficiali, verifica la fonte e scansiona archivi o download dubbi se non sei sicuro.
Avast offers free and premium antivirus software that protects against viruses, malware, ransomware, and phishing. Scan files before opening them to ensure safety.
NortonNorton 360 delivers comprehensive antivirus protection, VPN, and identity theft monitoring. Scan files for threats before opening to keep your device secure.
Potremmo guadagnare una commissione quando usi i link affiliati. Questo supporta le nostre guide gratuite sulle estensioni file.
Impossibile aprire questo file?
Le cause e le soluzioni più comuni quando i file .GQL non si aprono.
Cause comuni
- Il file si apre come testo normale senza evidenziazione o convalida GraphQL
- Gli strumenti di compilazione o generazione di codice ignorano i file .gql
- Le richieste hanno esito negativo in fase di esecuzione perché il documento .gql non è valido per lo schema del server
Passi per risolvere
- Installa/abilita gli strumenti del linguaggio GraphQL nel tuo editor (servizio/plugin del linguaggio GraphQL).
- Controlla le impostazioni dello strumento per le estensioni di file riconosciute e conferma che .gql sia incluso.
Risoluzione problemi specifica per SO
Cos'è un file .GQL?
Un file .gql è solitamente un file di testo contenente la sintassi del documento GraphQL (operazioni come query/mutazione/sottoscrizione e frammenti riutilizzabili). Gli strumenti comunemente trattano .gql come intercambiabile con altre estensioni di documenti GraphQL e i servizi linguistici degli editor spesso includono .gql nelle estensioni supportate predefinite.
Contesto
Il linguaggio principale di GraphQL descrive un "documento" basato su testo che può contenere operazioni e frammenti. In pratica, i team spesso mantengono questi documenti nel controllo del codice sorgente come file separati in modo che gli strumenti di creazione, i generatori di codice e le funzionalità IDE (completamento, convalida, navigazione) possano elaborarli.
All'interno dell'ecosistema, .gql è un'estensione comune per questi documenti. Ad esempio, gli esempi di strumenti mostrano file come query.gql e gli strumenti del servizio linguistico GraphQL elencano .gql tra le estensioni GraphQL riconosciute predefinite.
Su HTTP, le operazioni GraphQL vengono generalmente trasportate in payload basati su JSON, ma i documenti di query salvati su disco sono ancora testo semplice. Se offri risultati su HTTP, tieni presente che GraphQL su HTTP definisce un tipo di supporto di risposta specifico per le risposte GraphQL.
Tipi MIME comuni: application/graphql-response+json
Alias noti: .graphql
Approfondimenti
Risorse autorevoli per ulteriori dettagli sul formato .GQL.
- Specifica GraphQL (linguaggio GraphQL e sistema di schemi)
- GraphQL su HTTP (bozza): tipo di supporto di risposta application/graphql-response+json
- repository Apollo graphql-tag (esempi di utilizzo di query.gql)
- Registro dei tipi di media IANA (registro autorevole dei tipi MIME)
- Specifica del database condiviso di informazioni MIME (come le estensioni si associano ai tipi MIME sui desktop Linux)
Problemi comuni .GQL
Il file si apre come testo normale senza evidenziazione o convalida GraphQL
Molti editor trattano .gql come testo generico a meno che gli strumenti del linguaggio GraphQL non siano installati o configurati per includere .gql come estensione riconosciuta.
- Installa/abilita gli strumenti del linguaggio GraphQL nel tuo editor (servizio/plugin del linguaggio GraphQL).
- Controlla le impostazioni dello strumento per le estensioni di file riconosciute e conferma che .gql sia incluso.
Gli strumenti di compilazione o generazione di codice ignorano i file .gql
Alcune toolchain sono configurate per scansionare solo determinate estensioni (spesso .graphql) per i documenti GraphQL.
- Controlla la configurazione del tuo strumento per i globi/estensioni dei documenti inclusi e aggiungi *.gql se necessario.
- Se lo strumento non può essere configurato, rinominare il file con un'estensione che esegue la scansione (comunemente .graphql) mantenendo il contenuto invariato.
Le richieste hanno esito negativo in fase di esecuzione perché il documento .gql non è valido per lo schema del server
Un file .gql può essere GraphQL sintatticamente valido ma fallire comunque rispetto a uno schema specifico (campi mancanti, argomenti errati o mancata corrispondenza del tipo di frammento).
- Convalidare il documento utilizzando strumenti compatibili con lo schema (servizio linguistico GraphQL/integrazione IDE) rispetto allo schema corretto.
- Aggiorna l'operazione/i frammenti in modo che corrispondano allo schema del server e riprova.
FAQ
Un file .gql è uguale a .graphql?
Nella maggior parte dei contesti di strumenti, sì: entrambi vengono utilizzati per archiviare documenti GraphQL (operazioni e frammenti). Alcuni strumenti utilizzano per impostazione predefinita un'estensione o l'altra, quindi potrebbe essere necessario modificare la configurazione o rinominare i file.
.gql ha un tipo MIME ufficiale?
Il registro dei tipi di media IANA è il luogo autorevole per verificare le registrazioni. GraphQL su HTTP definisce un tipo di supporto per le risposte GraphQL: application/graphql-response+json.
Che tipo di contenuto dovrebbe essere presente in un file .gql?
Tipicamente operazioni GraphQL (query, mutazione, sottoscrizione) e frammenti scritti nel linguaggio GraphQL definito dalla specifica GraphQL.
Estensioni simili
Confronta formati correlati nella stessa categoria per trovare lo strumento giusto più velocemente.