KeyError trong Python: nghĩa là gì và cách sửa
Bài 7/13 · Chương 24
Giải nghĩa thông báo lỗi
- 7 phút
- Cơ bản
- Python 3.14
- Cập nhật
Trong bài này · 12
Thông báo KeyError: 'sinh tố bơ' trong Python nghĩa là chương trình tra dict bằng một khóa mà dict không có. Phần sau dấu hai chấm chính là khóa đó, in y nguyên. Bạn gặp lỗi này khi gõ sai tên khóa, sai chữ hoa, dư một dấu cách, tra bằng chuỗi '101' trong khi khóa là số 101, hay cộng dồn vào một khóa chưa từng được thêm.
Cần biết trước: dict và keys(), values(), items().
Bảng tra nhanh: nguyên nhân KeyError và cách sửa
Python gọi lỗi này là KeyError. Khác các lỗi khác, dòng cuối chỉ có tên lớp và khóa bị thiếu (trừ popitem()), không có câu giải thích. Dòng đó giống hệt nhau trên Python 3.12, 3.13, 3.14 và trên trang.
Phần sau | Nguyên nhân | Cách sửa |
|---|---|---|
| khóa không có trong dict |
|
| khóa có, nhưng khác chữ hoa | gõ đúng |
| dư dấu cách ở cuối khóa | bỏ dấu cách thừa |
| tra bằng chuỗi, khóa là số |
|
|
|
|
|
| kiểm tra |
| dict lồng nhau, tầng ngoài thiếu khóa | kiểm tra từng tầng |
|
| kiểm tra |
Hai dấu nháy quanh khóa trong thông báo giúp bạn thấy dấu cách thừa: 'bạc xỉu ' có một khoảng trắng trước dấu nháy đóng. Khóa là số thì thông báo in số đó, không có nháy. Chạy đoạn dưới để tra một khóa có thật:
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
mon = "trà đào"
print(mon, gia[mon])
print(list(gia.keys()))KẾT QUẢ
trà đào 35000
['cà phê sữa', 'bạc xỉu', 'trà đào']Đổi mon = "trà đào" thành mon = "Trà đào" rồi chạy lại: Python in KeyError: 'Trà đào'. In danh sách khóa bằng keys() như dòng cuối là cách nhanh để so khóa bạn tra với khóa dict đang có. Bài mẹ của trang này, bài keys(), values(), items(), dạy cách duyệt các khóa đó.
Khóa gần đúng: chữ hoa, dấu cách, chuỗi với số
Dict so khóa từng ký tự. "Trà đào" và "trà đào" là hai chuỗi khác nhau, nên tra bằng chữ hoa thì báo lỗi:
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
print(gia["Trà đào"])
Dòng cuối của thông báo lỗi:
KeyError: 'Trà đào'
Khóa chuỗi đọc từ input() hay hay dư dấu cách ở cuối, khi người dùng gõ thêm một phím cách trước Enter. Khóa là số thì tra bằng chuỗi cũng hỏng, dù trông giống nhau:
phong = {101: "Lan", 102: "Minh"}
so = "101"
print(phong[so])
Dòng cuối của thông báo lỗi:
KeyError: '101'
Nháy đơn quanh 101 trong thông báo cho biết khóa đã tra là chuỗi. Sửa bằng phong[int(so)].
Đếm bằng dict: dem[mon] += 1 báo KeyError
+= đọc giá trị cũ trước khi cộng. Ở lần đầu gặp một món, khóa chưa có trong dict nên chưa có giá trị cũ để đọc:
dem = {}
for mon in ["bạc xỉu", "trà đào", "bạc xỉu"]:
dem[mon] += 1
Dòng cuối của thông báo lỗi:
KeyError: 'bạc xỉu'
get(mon, 0) trả về 0 khi khóa chưa có, nên dòng đếm chạy được ngay từ lượt đầu:
dem = {}
for mon in ["bạc xỉu", "trà đào", "bạc xỉu"]:
dem[mon] = dem.get(mon, 0) + 1
print(dem)KẾT QUẢ
{'bạc xỉu': 2, 'trà đào': 1}Python còn hai cách khác cho mẫu này. setdefault() thêm khóa với giá trị ban đầu nếu khóa chưa có, bài nhóm dữ liệu theo khóa dùng nó để gom học viên theo lớp. defaultdict là một dict tự tạo giá trị ban đầu cho từng khóa mới, nên dem[mon] += 1 chạy được ngay.
Tra an toàn: get() và in
Tra bằng ngoặc vuông một khóa không có thì chương trình dừng:
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
print(gia["sinh tố bơ"])
Dòng cuối của thông báo lỗi:
KeyError: 'sinh tố bơ'
get() trả về None, hoặc giá trị mặc định bạn truyền vào, thay cho báo lỗi. in trả lời khóa có trong dict hay không:
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
print(gia.get("sinh tố bơ"))
print(gia.get("sinh tố bơ", 0))
print("sinh tố bơ" in gia, "bạc xỉu" in gia)KẾT QUẢ
None
0
False TrueDùng in khi chương trình cần làm việc khác cho khóa thiếu, như báo "món này hết". Dùng get() khi một giá trị mặc định là đủ. Xóa khóa cũng có cách không báo lỗi: gia.pop("sinh tố bơ", None) trả về None khi khóa không có, bài phương thức của dict có đủ các phương thức này.
Kiểm tra nhanh
Với
gia = {"trà đào": 35000, 101: "Lan"}, những lần tra nào báo KeyError?gia["Trà đào"]gia[101]gia["101"]gia.get("trà sữa")
Với
dem = {}, dòngdem["trà đào"] += 1báo gì?- Không lỗi,
demthành{'trà đào': 1} - Báo
KeyErrorvới khóa'trà đào' TypeError
- Không lỗi,
Trong khung bẫy dùng get(mon, 0), chương trình in gì?
- Báo lỗi
KeyError 6700032000
- Báo lỗi
Bài tập
Đếm món, tính tiền và tách món không có trong menu
gia là menu của quán, don là các món khách gọi trong buổi sáng. Dòng trong comment của starter đếm số lần gọi nhưng báo KeyError. Duyệt don và viết:
dem: số lần gọi mỗi món, kể cả món không có trong menu, đếm bằngdem.get().tong: tổng tiền các món có trong menu, chọn bằng câu lệnhif.khong_co: các món không có trong menu, theo thứ tự gọi, thêm bằng.append().
# for mon in don: dem[mon] += 1
gia = {"cà phê sữa": 29000, "bạc xỉu": 32000, "trà đào": 35000}
don = ["bạc xỉu", "trà đào", "bạc xỉu",
"sinh tố bơ", "cà phê sữa", "bạc xỉu"]
dem = {}
tong = 0
khong_co = []
# Viết code của bạn dưới dòng nàyTóm tắt
KeyErrorkèm một khóa trong nháy nghĩa là dict không có khóa đó; khóa được in y nguyên, kể cả dấu cách.Khóa phải khớp từng ký tự và đúng kiểu:
'Trà đào'khác'trà đào','101'khác101.dem[mon] += 1báo lỗi ở lần đầu gặp món; dùngdem.get(mon, 0) + 1.get()trảNonehoặc giá trị mặc định thay cho báo lỗi,incho biết khóa có hay không.setdefault()vàdefaultdictlà hai cách khác để có giá trị ban đầu cho khóa mới.get(k, 0)che mất khóa gõ sai: cần báo lại khóa thiếu thì kiểm tra bằngin.
Câu hỏi thường gặp
Lỗi KeyError là gì trong Python?
Đó là lỗi Python báo khi bạn tra, xóa hay cộng dồn vào một khóa mà dict không có. Dòng thông báo chỉ ghi khóa đó, nên việc đầu tiên là so khóa trong thông báo với list(d.keys()). Cách tạo và tra dict nằm ở bài dict.
Nên dùng get() hay kiểm tra in để tránh KeyError?
Dùng get() khi khóa thiếu chỉ cần một giá trị thay thế, như đếm từ 0. Dùng if k in d: khi khóa thiếu là chuyện cần xử lý riêng, như báo món hết hàng. Cả hai đều không làm thay đổi dict.
Vì sao khóa có trong dict mà vẫn báo KeyError?
Thường là khóa gần giống chứ không trùng: khác chữ hoa, dư dấu cách, có dấu và không dấu, hay chuỗi '101' so với số 101. Nhìn kỹ phần trong nháy của thông báo, rồi in list(d.keys()) để so. Bài keys(), values(), items() chỉ cách duyệt các khóa.
Xóa phần tử không có trong set bằng remove() có báo KeyError không?
Có, remove() của set báo KeyError kèm phần tử không có trong set, cùng dạng với dict. Bài thêm, xóa phần tử của set giới thiệu discard(), cách xóa không báo lỗi. Chỉ số vượt khỏi list là lỗi khác, có ở trang IndexError.
Chủ đề
Bài này có hữu ích?
Hỏi đáp
Tham vấn chuyên môn
Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE
- Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
- Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
- Xây hệ thống AI cho doanh nghiệp tại VietPlatform.