salut.sh: line 2: local: can only be used in a function
local declară o variabilă vizibilă doar în funcția curentă, deci nu are sens în afara unei funcții. Șterge cuvântul local (o atribuire simplă, nume=valoare) sau mută codul într-o funcție.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
local nume=valoare creează o variabilă care există doar cât rulează funcția în care e scrisă și nu strică o variabilă cu același nume din restul scriptului. În afara unei funcții, bash refuză: local: can only be used in a function, iar atribuirea nu se face, deci variabila rămâne goală. Scriptul continuă, așa că eroarea se vede adesea printr-un rezultat ciudat (Salut, !).
Apare când copiezi linii dintr-o funcție în corpul scriptului, când scoți codul dintr-o funcție la refactorizare, sau când ești obișnuit cu let/var din alte limbaje. O eroare înrudită, de aceeași natură, e return: can only return' from a function or sourced script: și return are sens doar într-o funcție; în corpul scriptului folosești exit`.
De ce apare: cauzele frecvente
1Linie copiată dintr-o funcție
#!/bin/bash
local nume=$1
echo "Salut, $nume!"#!/bin/bash
nume=$1
echo "Salut, $nume!"În corpul scriptului o variabilă se atribuie simplu, fără local.
2Codul trebuia să fie o funcție
local total=0
for f in *.log; do total=$((total + 1)); donenumara_loguri() {
local total=0
for f in *.log; do total=$((total + 1)); done
echo "$total"
}
numara_loguriÎn funcție, local e exact ce trebuie: total nu afectează restul scriptului.
3return în loc de exit
[ -f config.txt ] || return 1[ -f config.txt ] || exit 1return iese dintr-o funcție; scriptul se termină cu exit.
Repară eroarea, direct în pagină
Scriptul salut.sh trebuie să salute utilizatorul primit ca argument. ./salut.sh Ana dă salut.sh: line 2: local: can only be used in a function și afișează Salut, !. Repară scriptul ca ./salut.sh Ana să afișeze Salut, Ana!.
Indiciu
Linia 2 nu e într-o funcție; o atribuire simplă e suficientă.
Reparația
sed -i 's/^local nume=/nume=/' salut.sh
./salut.sh AnaRezultat:
Salut, Ana!De ce merge
local creează variabile vizibile doar într-o funcție, iar linia 2 este în corpul scriptului. Bash a refuzat declarația, deci nume a rămas goală și scriptul a afișat Salut, !.
O atribuire simplă, nume=$1, pune primul argument în variabilă. Dacă scriptul ar crește, ai putea pune salutul într-o funcție, unde local nume=$1 ar fi exact forma corectă.
Alte forme ale mesajului
bash: local: can only be used in a functionbash: return: can only `return' from a function or sourced scriptsalut.sh: line 5: return: can only `return' from a function or sourced scriptlocal: not in a function
Cum o eviți pe viitor
- Folosește
localpentru toate variabilele din interiorul funcțiilor și atribuiri simple în corpul scriptului. - Când muți cod dintr-o funcție în afara ei, caută
localșireturnși înlocuiește-le. - Rulează
bash -n script.shpentru sintaxă și apoi scriptul cu un argument de test: un rezultat gol (Salut, !) e semn că o atribuire nu s-a făcut. shellcheck, dacă îl ai, semnalează și aceste greșeli.
Întrebări frecvente
Ce se întâmplă dacă nu folosesc local în funcții?
Variabila devine globală: după apelul funcției, valoarea ei rămâne și poate suprascrie o variabilă cu același nume din script. local previne asta.
De ce scriptul a mers mai departe după eroare?
Pentru că local în afara funcției e o eroare obișnuită, nu una fatală. Doar atribuirea nu s-a făcut, iar variabila a rămas goală.
Erori înrudite
salut.sh: line 3: $1: unbound variable Scriptul are set -u (sau set -euo pipefail) și folosește o variabilă care nu are nicio valoare, aici primul argument ($1), care lipsește. Dă argumentul sau folosește o valoare implicită: ${1:-lume}. curata.sh: line 4: FOLDER: readonly variable Ai încercat să schimbi o variabilă declarată readonly (sau una a lui bash, ca UID, EUID, PPID), iar bash refuză. Folosește o variabilă nouă, cu alt nume, sau scoate readonly dacă valoarea chiar trebuie să se schimbe. verifica.sh: line 6: syntax error: unexpected end of file Bash a ajuns la finalul scriptului cu un bloc încă deschis: lipsește un fi (pentru if), un done (pentru for/while), un esac sau o acoladă }. Caută blocul neînchis și adaugă cuvântul de final. Î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.
