...
Eroare Linux · Scripturi bash: sintaxă și condiții

salut.sh: line 2: local: can only be used in a function

Pe scurt

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

Greșit
BASH
#!/bin/bash
local nume=$1
echo "Salut, $nume!"
Corect
BASH
#!/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

Greșit
BASH
local total=0
for f in *.log; do total=$((total + 1)); done
Corect
BASH
numara_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

Greșit
BASH
[ -f config.txt ] || return 1
Corect
BASH
[ -f config.txt ] || exit 1

return iese dintr-o funcție; scriptul se termină cu exit.

Repară tu

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ă.

Alte forme ale mesajului

  • bash: local: can only be used in a function
  • bash: return: can only `return' from a function or sourced script
  • salut.sh: line 5: return: can only `return' from a function or sourced script
  • local: not in a function

Cum o eviți pe viitor

  • Folosește local pentru 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 și return și înlocuiește-le.
  • Rulează bash -n script.sh pentru 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

← 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.