...
Eroare Python · Nume și variabile

SyntaxError: no binding for nonlocal 'contor' found

Pe scurt

Ai scris nonlocal contor într-o funcție interioară, dar funcția exterioară nu are nicio variabilă contor. nonlocal leagă doar de variabile ale unei funcții care o conține; pentru o variabilă de la nivelul fișierului, folosește global sau, mai bine, returnează valoarea.

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

Ce înseamnă

nonlocal x îi spune lui Python: „x din funcția asta e variabila x din funcția care mă conține”. Ca să funcționeze, trebuie să existe o funcție exterioară (nu nivelul modulului) care să atribuie x. Dacă nu există, legătura nu are unde să se facă și Python refuză fișierul: no binding for nonlocal 'contor' found.

Eroarea apare la compilare, deci înainte de rulare, la linia cu nonlocal. Cauze tipice: variabila e definită la nivelul fișierului (atunci ai nevoie de global, nu nonlocal), variabila e creată în funcția exterioară abia după funcția interioară sau deloc, ori ai scris nonlocal într-o funcție care nu e imbricată.

Înrudită: nonlocal declaration not allowed at module level, când scrii nonlocal direct în fișier.

De ce apare: cauzele frecvente

1Variabila e globală, nu a unei funcții exterioare

Greșit
PYTHON
contor = 0

def apasa():
    nonlocal contor
    contor += 1
Corect
PYTHON
contor = 0

def apasa():
    global contor
    contor += 1

apasa()
print(contor)

nonlocal caută doar în funcțiile care o conțin. Pentru variabilele de la nivelul fișierului există global.

2Funcția exterioară nu creează variabila

Greșit
PYTHON
def creeaza_contor():
    def apasa():
        nonlocal total
        total += 1
        return total
    return apasa
Corect
PYTHON
def creeaza_contor():
    total = 0
    def apasa():
        nonlocal total
        total += 1
        return total
    return apasa

apasa = creeaza_contor()
apasa()
print(apasa())

Variabila trebuie să existe în funcția exterioară (aici total = 0), ca să aibă de ce se lega.

Repară tu

Repară eroarea, direct în pagină

Funcția creeaza_contor ar trebui să întoarcă o funcție care numără apăsările unui buton, dar Python dă SyntaxError: no binding for nonlocal 'apasari' found. Repară codul ca, după trei apeluri, programul să afișeze 3.

Codul care dă eroarea
PYTHON
def creeaza_contor():
    def apasa():
        nonlocal apasari
        apasari += 1
        return apasari
    return apasa

buton = creeaza_contor()
buton()
buton()
print(buton())
După reparație, programul afișează
3
Indiciu

nonlocal are nevoie de o variabilă creată în funcția exterioară.

Alte forme ale mesajului

  • SyntaxError: no binding for nonlocal 'total' found
  • SyntaxError: nonlocal declaration not allowed at module level

Cum o eviți pe viitor

  • Folosește nonlocal doar în funcții imbricate (closure-uri), după ce funcția exterioară a creat variabila.
  • Pentru stare simplă, evită atât global, cât și nonlocal: primește valoarea ca parametru și returnează noua valoare.
  • Pentru stare care durează, o clasă mică e adesea mai clară decât un closure.

Întrebări frecvente

Care e diferența dintre global și nonlocal?

global leagă de variabila de la nivelul fișierului (modulului). nonlocal leagă de variabila celei mai apropiate funcții exterioare. La nivelul fișierului nu există „nonlocal”.

Am nevoie de nonlocal ca să citesc variabila?

Nu. Doar ca să o modifici (+=, =). Pentru citire, funcția interioară vede singură variabilele funcției exterioare.

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.