Python TypeError: unhashable type: 'list' hatası, bir listeyi sözlük anahtarı ya da küme elemanı olarak kullandığında ortaya çıkar. Liste değiştirilebilir olduğu için Python bu nesneden sözlükte veya kümede güvenle kullanılacak sabit bir hash değeri üretemez. Çözüm, listeyi rastgele başka bir türe çevirmek yerine kullanılan veri yapısının amacını incelemektir.
Python bu hatayı neden verir?

Liste değiştirilebilir olduğu için sözlük anahtarı veya küme elemanı olarak kullanılamaz. Hash, Python’un bir değeri sözlükte anahtar veya kümede eleman olarak bulup yönetebilmek için kullandığı, nesnenin yaşamı boyunca tutarlı kalması gereken sayısal özettir. Listenin içeriği sonradan değişebildiğinden liste bu kullanım amacına uygun değildir.
Aşağıdaki örnekte liste, sözlüğün anahtarı olarak kullanılıyor:
dersler = {["Python", "Java"]: "programlama"}
Python 3 çalıştırmasında hata mesajının son satırı şöyle görünür:
TypeError: unhashable type: 'list'
Listeyi sözlükte değer olarak tutmak ise geçerli bir kullanımdır. Çünkü sözlük anahtarının hashable olması gerekirken değerler listeler gibi değiştirilebilir nesneler olabilir.
dersler = {"programlama": ["Python", "Java"]}
print(dersler["programlama"])
Bu kodun çıktısı şöyledir:
['Python', 'Java']
Benzer hata, listeyi kümeye ekleyen bir döngüde de oluşur:
etiketler = [["python", "temel"], ["java", "temel"]]
etiket_kumesi = set()
for etiket in etiketler:
etiket_kumesi.add(etiket)
add() metodu kümeye tek bir eleman ekler ve bu elemanın hashable olmasını bekler. Döngünün ilk turunda etiket bir liste olduğu için işlem TypeError: unhashable type: 'list' hatasıyla durur.
Listeyi tuple’a çevirmek bazı durumlarda uygun olabilir, ancak bu otomatik bir düzeltme değildir. Tuple’ın içindeki her elemanın da hashable olması gerekir. Örneğin liste içeren bir tuple hâlâ hashable değildir:
anahtar = (["Python", "Java"],)
sozluk = {anahtar: "programlama"}
Ayrıca str() kullanarak listeyi metne dönüştürmek, söz konusu verinin yapısını değiştirir. Sonraki işlemlerde listenin elemanlarına erişmek, eleman eklemek veya liste olarak karşılaştırma yapmak gerekiyorsa bu yaklaşım veri modelini bozabilir.
Traceback hatanın oluştuğu satırı nasıl gösterir?
Traceback, hatanın oluştuğu dosyayı, satır numarasını ve işlemi göstererek sorunun hangi ifadede başladığını bulmanı sağlar. Önce son satırdaki hata türünü oku, ardından üst bölümdeki dosya adı ve satır numarasını takip ederek listeyi sözlük anahtarı ya da küme elemanı olarak kullanan ifadeyi incele.
def ders_ekle():
anahtar = ["Python", "Java"]
return {anahtar: "programlama"}
ders_ekle()
Bu kod çalıştırıldığında traceback şu yapıda görünür:
Traceback (most recent call last):
File "ornek.py", line 5, in <module>
ders_ekle()
File "ornek.py", line 3, in ders_ekle
return {anahtar: "programlama"}
TypeError: unhashable type: 'list'
Burada son satır hata türünü ve nedenini verir. File "ornek.py", line 3 satırı ise hatanın return {anahtar: "programlama"} ifadesinde oluştuğunu gösterir. Böylece bütün sözlüğü veya programdaki tüm listeleri değiştirmek yerine yalnızca sorunlu kullanımı inceleyebilirsin.
- Son satırda
TypeErrorveunhashable type: 'list'ifadesini bul. - Traceback içinde dosya adını ve satır numarasını belirle.
- Gösterilen satırda listenin sözlük anahtarı olarak mı kullanıldığını kontrol et.
- Liste bir kümeye ekleniyorsa
add()çağrısını ve döngü değişkeninin türünü incele. - Veri yapısının tamamını değiştirmeden önce yalnızca hatayı üreten işlemi küçük bir örnekle izole et.
Listeyi tuple yapmak ne zaman doğru çözümdür?

Listeyi tuple yapmak, listedeki değerler bir sözlük anahtarının veya küme elemanının kimliğini oluşturuyor ve sonradan değişmemesi gerekiyorsa uygun bir çözümdür. Hash, bir değeri hızlıca bulmak için kullanılan sayısal özettir. Liste değiştirilebilir olduğu için sözlük anahtarı ya da küme elemanı olarak kullanılamaz; tuple ise içindeki değerler de hash edilebildiğinde bu amaçla kullanılabilir.
Ders saatlerini bir sözlükte anahtar olarak saklamak istediğini düşünelim. Listeyle yazılan örnek çalıştırıldığında hata oluşur:
ders_bilgisi = {[9, 10]: "Matematik"}
TypeError: unhashable type: 'list'
Aynı saatleri tuple olarak yazdığında sözlük anahtarı oluşturulabilir:
ders_bilgisi = {(9, 10): "Matematik"}
print(ders_bilgisi[(9, 10)])
Matematik
Bu çözümde saat aralığı, sözlükte değişmemesi gereken bir kimlik olarak ele alınır. Verinin programın ilerleyen bölümünde güncellenmesi gerekiyorsa tuple kullanmak yerine listeyi korumak veya farklı bir veri modeli seçmek daha uygundur.
Tuple kullanırken içindeki değerleri de kontrol etmelisin. Tuple’ın kendisi değiştirilemez olsa da içinde değiştirilebilir bir liste bulunabilir. Böyle bir tuple hash edilmeye çalışıldığında hata devam eder:
anahtar = ([9, 10],)
print(hash(anahtar))
TypeError: unhashable type: 'list'
Bu nedenle yalnızca dış kapsayıcıyı tuple’a çevirmek yeterli olmayabilir. Tuple’ın bütün elemanlarının da hash edilebilir olması gerekir.
Kümeye liste eklenince hangi seçenekler değerlendirilir?
Kümeye liste eklemek de hata verir, çünkü set üyeleri hash edilebilir değerlerden oluşmalıdır. add() metodu listeyi kümeye yerleştirmeye çalışırken şu sonuç alınır:
ders_saatleri = [[9, 10], [13, 14]]
saatler = set()
for saat in ders_saatleri:
saatler.add(saat)
TypeError: unhashable type: 'list'
Her listenin değerleri sabit bir saat aralığını temsil ediyorsa döngü içinde tuple’a çevrilebilir:
ders_saatleri = [[9, 10], [13, 14]]
saatler = set()
for saat in ders_saatleri:
saatler.add(tuple(saat))
print(saatler)
{(9, 10), (13, 14)}
Bu gösterim bir olası çıktıdır. Set elemanların sırasını saklamadığı için tuple’ların ekrana geliş sırası değişebilir. dict veya değiştirilebilir bir set nesnesi de başka bir sözlüğün anahtarı ya da kümenin elemanı yapılmak istendiğinde benzer bir TypeError oluşturabilir.
Elemanların sırası önemli değilse, tekrarlar anlam taşımıyorsa ve iç değerlerin tamamı hash edilebiliyorsa frozenset tercih edilebilir. frozenset değiştirilemediği için sözlük anahtarı veya başka bir kümenin elemanı olarak kullanılabilir:
etiketler = {
frozenset({"python", "java"}),
frozenset({"python", "java"})
}
print(len(etiketler))
1
Karar verirken şu kontrol listesini kullanabilirsin:
- Veri sonradan değişecekse liste veya değiştirilebilir başka bir yapı kullan.
- Sıra önemliyse tuple, tekrarlar önemli değilse ve değerler hash edilebiliyorsa frozenset seçeneğini değerlendir.
str()ile dönüştürmeden önce veri modelini incele; bu yöntem yapısal veriyi metne çevirir ve daha sonra değerleri yeniden kullanmayı zorlaştırabilir.
Bu ayrımı kısa alıştırmalarla pekiştirmek için Python bilgi testini kullanabilirsin.
Sık Sorulan Sorular
Bir listeyi her durumda tuple’a çevirmek doğru mudur?
Bir listeyi tuple’a çevirmek, değerlerin değişmemesi gerektiğinde ve sözlük anahtarı ya da küme elemanı olarak kullanılacağı zaman uygundur. Veri üzerinde ekleme, silme veya güncelleme yapılacaksa listeyi korumak ya da başka bir veri modeli seçmek gerekir.
Tuple içine liste koyarsam unhashable type list hatası neden devam eder?
Tuple’ın hash edilebilmesi için içindeki bütün elemanların hash edilebilir olması gerekir. İçeride bir liste bulunduğunda Python bu listeyi hash edemediği için tuple da sözlük anahtarı veya küme elemanı olarak kullanılamaz.
Listeyi str() ile sözlük anahtarına çevirmek güvenli bir çözüm müdür?
Listeyi str() ile metne çevirmek teknik olarak hash edilebilir bir anahtar oluşturabilir, ancak yapısal veriyi metin biçimine dönüştürür. Anahtarı daha sonra tekrar liste olarak kullanmak veya değerleri güvenilir biçimde ayrıştırmak zorlaşabileceği için bu yöntemi veri modelini incelemeden seçmemelisin.
dict veya set için aynı hata çıktığında frozenset ne zaman kullanılabilir?
frozenset, elemanların sırasının önemli olmadığı, tekrarların ayırt edilmesi gerekmediği ve iç değerlerin hash edilebildiği durumlarda kullanılabilir. Değiştirilemediği için sözlük anahtarı veya başka bir kümenin elemanı olarak görev yapabilir.
Hatanın çözümü, yalnızca parantezleri değiştirmekten çok verinin program içinde nasıl davranması gerektiğini belirlemeye dayanır.