jq: error: syntax error, unexpected INVALID_CHARACTER (Unix shell quoting issues?) at <top-level>, line 1:
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
jq -r '.[] | select(.oras == “Cluj”) | .nume' clienti.jsonjq -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
jq ".[] | select(.oras == 'Cluj')" clienti.jsonjq '.[] | 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
jq ‘.[0].nume’ clienti.jsonjq '.[0].nume' clienti.jsonBash nu recunoaște ‘ ’ ca ghilimele, deci jq primește caracterele ca parte din filtru.
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.
Reparația
sed -i 's/“Cluj”/"Cluj"/' cluj.sh
./cluj.shRezultat:
AnaDe ce merge
Documentul a înlocuit ghilimelele drepte cu ghilimele tipografice “ ”. Pentru jq acestea sunt caractere necunoscute, nu delimitatori de text, așa că filtrul nu a putut fi compilat.
Cu ghilimele drepte, "Cluj" e un șir jq, select păstrează doar clienții din Cluj, iar .nume afișează numele lor.
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
jq: error: nume/0 is not defined at <top-level>, line 1: jq a citit nume ca pe numele unei funcții, nu al unui câmp, pentru că lipsește punctul din față. Câmpurile se scriu cu punct: .nume, .oras, .[] | .nume. Uneori punctul s-a pierdut din cauza ghilimelelor din bash. jq: error (at <stdin>:1): Cannot index array with "nume" JSON-ul primit e o listă ([...]), iar tu ai cerut un câmp ca la un obiect (.nume). Parcurge întâi lista cu .[] și abia apoi alege câmpul: jq -r '.[].nume'. Uită-te la forma datelor cu jq . înainte să scrii filtrul. salut.sh: line 4: unexpected EOF while looking for matching `"' Ai deschis ghilimele (") și nu le-ai închis, așa că bash a citit restul scriptului ca text, până la final. Caută linia cu numărul impar de ghilimele (de obicei mai sus decât linia din mesaj) și închide-le. Î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.
