...
Eroare Python · Erori de tip (TypeError)

TypeError: unhashable type: 'list'

Pe scurt

Folosești o listă drept cheie de dicționar sau ca element într-un set, dar acestea acceptă doar valori imuabile (texte, numere, tupluri). Transformă lista în tuplu (`tuple(lista)`) sau alege altă cheie.

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

Ce înseamnă

Dicționarele și seturile găsesc rapid elementele folosind un hash, un număr calculat din valoare. Ca hash-ul să rămână valabil, valoarea nu trebuie să se poată schimba. De aceea doar tipurile imuabile sunt „hashable”: int, float, str, tuple (cu elemente imuabile), bool, None. Listele, dicționarele și seturile se pot modifica, deci nu pot fi chei.

Mesajul unhashable type: 'list' înseamnă că ai pus o listă într-un loc unde trebuia o valoare hashable: o cheie d[[1, 2]], un element {[1, 2]}, set(lista_de_liste) sau lista in set. În Python 3.14 mesajul e mai precis: cannot use 'list' as a dict key (unhashable type: 'list') sau cannot use 'list' as a set element (...). La fel apare unhashable type: 'dict' pentru dicționare.

De ce apare: cauzele frecvente

1Listă folosită drept cheie

Greșit
PYTHON
distante = {}
distante[["Cluj", "Iasi"]] = 400
Corect
PYTHON
distante = {}
distante[("Cluj", "Iasi")] = 400

Tuplul nu se poate modifica, deci e o cheie validă. Lista nu.

2Eliminarea duplicatelor dintr-o listă de liste

Greșit
PYTHON
puncte = [[1, 2], [3, 4], [1, 2]]
unice = set(puncte)
Corect
PYTHON
puncte = [[1, 2], [3, 4], [1, 2]]
unice = set(tuple(p) for p in puncte)

Un set nu poate conține liste, dar poate conține tupluri. Transformă fiecare element înainte.

3Dicționar pus într-un set

Greșit
PYTHON
vazuti = set()
vazuti.add({"id": 7})
Corect
PYTHON
vazuti = set()
vazuti.add(7)

În set păstrează doar o valoare imuabilă care identifică obiectul, de exemplu id-ul lui. Mesajul ar fi unhashable type: 'dict'.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos vrea să numere de câte ori a fost parcursă fiecare rută, dar dă TypeError cu unhashable type: 'list'. Repară-l ca să afișeze ('Cluj', 'Iasi') 2 și ('Brasov', 'Sibiu') 1, pe câte un rând.

Codul care dă eroarea
PYTHON
rute = [["Cluj", "Iasi"], ["Brasov", "Sibiu"], ["Cluj", "Iasi"]]
numar = {}
for r in rute:
    numar[r] = numar.get(r, 0) + 1
for ruta, n in numar.items():
    print(ruta, n)
După reparație, programul afișează
('Cluj', 'Iasi') 2
('Brasov', 'Sibiu') 1
Indiciu

Cheia dicționarului nu poate fi o listă: transform-o în tuplu.

Alte forme ale mesajului

  • TypeError: cannot use 'list' as a dict key (unhashable type: 'list')
  • TypeError: cannot use 'list' as a set element (unhashable type: 'list')
  • TypeError: unhashable type: 'dict'
  • TypeError: unhashable type: 'set'

Cum o eviți pe viitor

  • Ca chei de dicționar folosește texte, numere sau tupluri.
  • Când grupezi după mai multe valori, combină-le într-un tuplu: d[(oras, an)].
  • Pentru a elimina duplicate din liste de liste, transformă elementele în tupluri.
  • Pentru un set de seturi, folosește frozenset, varianta imuabilă a setului.

Întrebări frecvente

Un tuplu e mereu hashable?

Doar dacă toate elementele lui sunt hashable. (1, 2) merge, dar (1, [2, 3]) dă tot unhashable type: 'list', pentru că lista din interior se poate schimba.

Ce înseamnă hashable, pe scurt?

Că valoarea are un hash fix pe toată durata ei de viață și poate fi comparată cu ==. Asta permite dicționarelor și seturilor să o găsească direct, fără să caute prin toate elementele.

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.