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

salut.sh: line 3: $1: unbound variable

Pe scurt

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

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

Ce înseamnă

Implicit, bash înlocuiește o variabilă nedefinită cu text gol și merge mai departe. Cu set -u (parte din combinația des recomandată set -euo pipefail), orice variabilă nedefinită devine o eroare care oprește scriptul, cu mesajul nume: unbound variable. E un lucru bun: o greșeală de scriere ($fisierr) sau un argument uitat nu mai produce efecte ciudate, ci o eroare clară.

Mesajul arată linia și numele variabilei. Pentru argumentele scriptului apare cu $ ($1: unbound variable), pentru celelalte doar numele (DB_HOST: unbound variable). Variabilele care pot lipsi în mod normal primesc o valoare implicită cu ${var:-implicit}, iar cele obligatorii se verifică la început, cu un mesaj de utilizare.

De ce apare: cauzele frecvente

1Argument lipsă

Greșit
BASH
#!/bin/bash
set -u
echo "Salut, $1!"
Corect
BASH
#!/bin/bash
set -u
echo "Salut, ${1:-lume}!"

${1:-lume} folosește lume când $1 lipsește sau e gol, fără să declanșeze set -u.

2Variabilă de mediu nesetată

Greșit
BASH
set -u
echo "Conectare la $DB_HOST"
Corect
BASH
set -u
: "${DB_HOST:?Seteaza DB_HOST}"
echo "Conectare la $DB_HOST"

${VAR:?mesaj} oprește scriptul cu un mesaj clar dacă variabila obligatorie lipsește.

3Nume scris greșit

Greșit
BASH
set -u
fisier=raport.txt
cat "$fisierr"
Corect
BASH
set -u
fisier=raport.txt
cat "$fisier"

Aici set -u își face treaba: fără el, cat "" ar da o eroare mult mai greu de înțeles.

Repară tu

Repară eroarea, direct în pagină

Scriptul salut.sh (cu set -u) afișează Salut, NUME! pentru numele primit ca argument. Rulat fără argument, bash salut.sh se oprește cu salut.sh: line 3: $1: unbound variable. Păstrează set -u și repară scriptul astfel încât fără argument să afișeze Salut, lume!, iar cu argumentul Ana să afișeze Salut, Ana!.

Indiciu

Bash are o formă de expansiune care dă o valoare implicită când variabila lipsește.

Alte forme ale mesajului

  • bash: nedefinit: unbound variable
  • ./deploy.sh: line 5: DB_HOST: unbound variable
  • salut.sh: line 3: 1: unbound variable

Cum o eviți pe viitor

  • Păstrează set -u (sau set -euo pipefail) în scripturi: îți arată devreme greșelile.
  • Dă valori implicite argumentelor opționale: ${1:-implicit}.
  • Verifică argumentele obligatorii la început: [ $# -ge 1 ] || { echo "Utilizare: $0 NUME" >&2; exit 2; }.
  • Pentru tablouri goale în bash vechi, folosește ${arr[@]+"${arr[@]}"}.

Întrebări frecvente

Să scot set -u ca să scap de eroare?

Nu. Eroarea îți arată o problemă reală: scriptul a fost rulat fără datele de care are nevoie. Repară cauza (valoare implicită sau verificare cu mesaj), nu ascunde avertismentul.

Care e diferența dintre ${1:-x} și ${1-x}?

${1:-x} folosește x și când $1 lipsește, și când e gol. ${1-x} îl folosește doar când lipsește; un argument gol ("") rămâne gol.

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.