...
Eroare Python · Nume și variabile

UnboundLocalError: cannot access local variable 'contor' where it is not associated with a value

Pe scurt

În funcție modifici o variabilă din afara ei (de exemplu `contor += 1`), iar Python o consideră locală funcției, deci fără valoare încă. Trimite valoarea ca parametru și returnează rezultatul sau, dacă chiar vrei variabila globală, declar-o cu `global`.

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

Ce înseamnă

Regula lui Python: dacă într-o funcție atribui o valoare unui nume (x = ..., x += 1), acel nume devine variabilă locală pentru toată funcția, chiar și pe liniile de dinaintea atribuirii. Când citești variabila înainte ca ea să primească valoare în funcție, Python nu se uită la variabila cu același nume din afară, ci dă UnboundLocalError.

Mesajul cannot access local variable 'contor' where it is not associated with a value înseamnă: contor e locală aici, dar în momentul ăsta nu are încă nicio valoare. Cazul clasic este contor += 1 într-o funcție, unde contor a fost definit în afara ei: += înseamnă citește și apoi scrie, iar citirea eșuează. În versiunile mai vechi mesajul era local variable 'contor' referenced before assignment.

De ce apare: cauzele frecvente

1+= pe o variabilă globală

Greșit
PYTHON
vizite = 0

def inregistreaza():
    vizite += 1

inregistreaza()
Corect
PYTHON
vizite = 0

def inregistreaza(vizite):
    return vizite + 1

vizite = inregistreaza(vizite)

vizite += 1 face din vizite o variabilă locală, care nu are valoare la citire. Varianta corectă primește valoarea ca parametru și o returnează.

2Variabila primește valoare doar pe o ramură

Greșit
PYTHON
def calificativ(nota):
    if nota >= 5:
        rezultat = "admis"
    return rezultat

print(calificativ(3))
Corect
PYTHON
def calificativ(nota):
    rezultat = "respins"
    if nota >= 5:
        rezultat = "admis"
    return rezultat

print(calificativ(3))

Pentru nota 3, ramura if nu rulează și rezultat nu primește valoare. O valoare inițială acoperă toate cazurile.

3Funcție interioară care modifică variabila funcției exterioare

Greșit
PYTHON
def numarator():
    n = 0
    def pas():
        n += 1
        return n
    return pas
Corect
PYTHON
def numarator():
    n = 0
    def pas():
        nonlocal n
        n += 1
        return n
    return pas

nonlocal n îi spune lui Python că n e variabila funcției exterioare, nu una locală nouă.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă UnboundLocalError la primul apel al funcției. Repară funcția adauga_in_cos ca să primească numărul curent de produse ca parametru și să returneze numărul nou. Programul trebuie să afișeze Produse în coș: 3.

Codul care dă eroarea
PYTHON
produse = 0

def adauga_in_cos():
    produse += 1

adauga_in_cos()
adauga_in_cos()
adauga_in_cos()
print("Produse în coș:", produse)
După reparație, programul afișează
Produse în coș: 3
Indiciu

Funcția să primească produse ca parametru și să întoarcă produse + 1; la apel, salvează rezultatul înapoi în variabilă.

Alte forme ale mesajului

  • UnboundLocalError: local variable 'contor' referenced before assignment
  • NameError: cannot access free variable 'n' where it is not associated with a value in enclosing scope

Cum o eviți pe viitor

  • Preferă funcțiile care primesc date prin parametri și dau rezultatul cu return, în locul celor care modifică variabile globale.
  • Dă variabilelor o valoare inițială la începutul funcției, înainte de if-uri și bucle.
  • Folosește global sau nonlocal doar când chiar ai nevoie să modifici variabila din afară, și cu măsură.

Întrebări frecvente

De ce pot citi variabila globală, dar nu o pot modifica?

Dacă doar citești contor în funcție, Python o caută în afară și o găsește. În clipa în care există o atribuire către contor oriunde în funcție, Python o tratează ca locală în toată funcția, iar citirea de dinainte eșuează.

E bine să folosesc global?

Funcționează, dar face codul greu de urmărit și de testat, pentru că orice funcție poate schimba variabila. Pentru programe mici e acceptabil; în general e mai curat să returnezi valoarea nouă sau să o ții într-un obiect.

Erori înrudite

← Toate erorile Python

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ță Python de la zero, cu exerciții la fiecare lecție

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