...
Eroare Linux · Prelucrare de text și căutare: sed și find

jq: error: syntax error, unexpected INVALID_CHARACTER (Unix shell quoting issues?) at <top-level>, line 1:

Pe scurt

Filtrul jq conține un caracter pe care limbajul nu-l acceptă, aproape mereu ghilimele „inteligente” (“Cluj” sau ‘.nume’) copiate dintr-un document, sau ghilimele simple în locul celor duble. Rescrie ghilimelele de mână: apostrofuri drepte în jurul filtrului, ghilimele duble drepte în jurul textelor.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

jq îți spune că a găsit în filtru un caracter invalid și te întreabă chiar el dacă nu e o problemă de ghilimele în shell (Unix shell quoting issues?). Sub mesaj afișează filtrul primit, iar la final jq: 1 compile error.

Cauzele tipice: ai copiat comanda dintr-un document Word, Slack sau o pagină web care a transformat ghilimelele drepte în ghilimele tipografice (“ ” sau ‘ ’); ai folosit apostrofuri pentru texte în interiorul filtrului (select(.oras == 'Cluj'), dar jq acceptă doar ghilimele duble pentru șiruri); pe Windows (cmd/PowerShell) apostrofurile nu funcționează ca în bash. Uită-te atent la caracterele de ghilimele din linia afișată sub mesaj.

De ce apare: cauzele frecvente

1Ghilimele tipografice copiate

Greșit
BASH
jq -r '.[] | select(.oras == “Cluj”) | .nume' clienti.json
Corect
BASH
jq -r '.[] | select(.oras == "Cluj") | .nume' clienti.json

“ și ” nu sunt ghilimele pentru jq. Doar " drept delimitează un șir.

2Apostrof în loc de ghilimele în filtru

Greșit
BASH
jq ".[] | select(.oras == 'Cluj')" clienti.json
Corect
BASH
jq '.[] | select(.oras == "Cluj")' clienti.json

În jq, textele se scriu doar cu ghilimele duble. Apostrofurile sunt pentru bash, în jurul întregului filtru.

3Tot filtrul între apostrofuri tipografice

Greșit
BASH
jq ‘.[0].nume’ clienti.json
Corect
BASH
jq '.[0].nume' clienti.json

Bash nu recunoaște ‘ ’ ca ghilimele, deci jq primește caracterele ca parte din filtru.

Repară tu

Repară eroarea, direct în pagină

Scriptul cluj.sh trebuie să afișeze numele clienților din Cluj din clienti.json. Comanda a fost copiată dintr-un document și dă jq: error: syntax error, unexpected INVALID_CHARACTER (Unix shell quoting issues?). Repară ghilimelele din filtru ca scriptul să afișeze Ana.

Indiciu

Uită-te atent la ghilimelele din jurul lui Cluj.

Alte forme ale mesajului

  • jq: error: syntax error, unexpected INVALID_CHARACTER, expecting $end (Unix shell quoting issues?) at <top-level>, line 1:
  • jq: error: syntax error, unexpected INVALID_CHARACTER (Windows cmd shell quoting issues?) at <top-level>, line 1:
  • jq: error: syntax error, unexpected $end, expecting QQSTRING_TEXT or QQSTRING_INTERP_START or QQSTRING_END (Unix shell quoting issues?) at <top-level>, line 1:
  • jq: 1 compile error

Cum o eviți pe viitor

  • Nu copia comenzi din documente care formatează textul; folosește blocuri de cod sau scrie ghilimelele de mână.
  • În editor, dezactivează „smart quotes” pentru fișierele de cod.
  • Regula jq în bash: filtrul între apostrofuri '...', textele din filtru între ghilimele duble "...".
  • Pentru filtre lungi, pune-le într-un fișier și rulează jq -f filtru.jq date.json.

Întrebări frecvente

Cum văd dacă ghilimelele sunt tipografice?

Rulează cat -A script.sh sau grep -n '[“”‘’]' script.sh: ghilimelele tipografice apar ca secvențe ciudate (M-bM-^@M-^\) sau sunt găsite de grep.

Ce e $end din unele variante ale mesajului?

Sfârșitul filtrului. unexpected $end înseamnă că filtrul s-a terminat prea devreme, de obicei din cauza unor ghilimele neînchise.

Erori înrudite

← Toate erorile Linux

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Linux de la zero, cu exerciții la fiecare lecție

Curs Linux: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.