IndentationError, TabError trong Python: lỗi thụt lề
Bài 2/13 · Chương 24
Giải nghĩa thông báo lỗi
- 8 phút
- Cơ bản
- Python 3.14
- Cập nhật
Trong bài này · 13
Lỗi thụt lề trong Python, dòng cuối mở bằng IndentationError: hoặc TabError:, nghĩa là khoảng trắng ở đầu một dòng không khớp với khối lệnh mà Python đang chờ. Bạn gặp nó khi quên thụt thân if, thụt thừa một dòng, lùi lề về một mức lạ, hay trộn phím Tab với dấu cách khi sửa code trong hai trình soạn thảo khác nhau.
Cần biết trước: cú pháp Python và câu lệnh if else.
Bảng tra nhanh: thông báo IndentationError và TabError
Trang này gom hai lớp lỗi, IndentationError và TabError. Cả hai là dạng riêng của SyntaxError: Python phát hiện chúng khi đọc file, trước khi chạy dòng đầu tiên. Python 3.12, 3.13 và 3.14 in giống hệt nhau các thông báo trong bảng.
Lớp | Thông báo | Nguyên nhân | Cách sửa |
|---|---|---|---|
IndentationError |
| dòng sau | thụt thân |
IndentationError |
| thân | thụt thân |
IndentationError |
| thân vòng lặp | thụt thân |
IndentationError |
| thân hàm | thụt thân hàm vào |
IndentationError |
| một dòng thụt vào mà không thuộc khối nào | đưa dòng đó về đúng mức của khối chứa nó |
IndentationError |
| dòng lùi lề về một mức không có ở phía trên | lùi về đúng mức của một dòng phía trên |
TabError |
| khối trộn phím Tab với dấu cách | đổi các Tab thành bốn dấu cách |
SyntaxError |
|
| đưa |
Đoạn dưới thụt đúng: thân mỗi nhánh vào bốn dấu cách, dòng cuối về sát lề nên chạy sau cả câu lệnh if.
diem = 4
if diem >= 5:
print("Đạt")
else:
print("Chưa đạt")
print("Đã chấm xong")KẾT QUẢ
Chưa đạt
Đã chấm xongĐổi diem = 4 thành diem = 4 rồi chạy lại: Python in IndentationError: unexpected indent. Dòng đầu của chương trình không nằm trong khối nào nên không được thụt. Bài if else, bài mẹ của trang này, dạy cách một khối lệnh mở bằng dấu hai chấm.
Thân khối trống: expected an indented block
Sau dòng kết thúc bằng dấu hai chấm, Python chờ ít nhất một dòng thụt vào sâu hơn. Dòng tiếp theo sát lề thì Python dừng:
diem = 8
if diem >= 5:
print("Đạt")
Dòng cuối của thông báo lỗi:
IndentationError: expected an indented block after 'if' statement on line 2
Thông báo nói tới dòng mở khối (line 2), còn số dòng ở đầu thông báo là dòng 3, nơi Python thấy thân bị thiếu. Trên trang, khi nút Chạy gặp lỗi này, dòng trạng thái cũng ghi Dòng 3: trước cùng thông báo đó. Cùng thông báo, chỉ khác chữ sau after, xuất hiện với vòng lặp for (after 'for' statement) và với hàm tự viết (after function definition).
Một dòng comment không tính là thân khối. Thân chỉ có comment thì Python báo đúng lỗi này ở dòng code kế tiếp:
diem = 8
if diem >= 5:
# sẽ in lời khen sau
print("Xong")
Dòng cuối của thông báo lỗi:
IndentationError: expected an indented block after 'if' statement on line 2
Thân chưa viết thì đặt tạm câu lệnh pass, câu lệnh không làm gì:
diem = 8
if diem >= 5:
pass # sẽ in lời khen sau
print("Xong")KẾT QUẢ
XongThụt thừa: unexpected indent
Python không cho thụt lề một dòng chỉ để nhìn cho thoáng. Dòng thụt vào phải nằm ngay dưới một dòng mở khối:
ten = "Trần Thu Hà"
print(ten)
Dòng cuối của thông báo lỗi:
IndentationError: unexpected indent
Lỗi này hay đến khi dán code chép từ trang khác: các dòng dán vào mang theo khoảng trắng đầu dòng của nơi chép. Chọn cả đoạn vừa dán rồi lùi lề cho tới khi dòng đầu sát lề, các dòng thân giữ đúng một mức.
Lùi lề lệch mức: unindent does not match any outer indentation level
Khi lùi lề, dòng mới phải thẳng cột với một dòng phía trên. Dưới đây thân if thụt tám dấu cách, dòng sau lùi về bốn, một mức không dòng nào ở trên có:
diem = 8
if diem >= 5:
print("Đạt")
print("Được thưởng")
Dòng cuối của thông báo lỗi:
IndentationError: unindent does not match any outer indentation level
Lệch lề ở dòng else lại ra một thông báo khác. Dòng else phải thẳng cột với dòng if của nó, thụt vào như một dòng thân thì Python không ghép được nó với if:
diem = 4
if diem >= 5:
print("Đạt")
else:
print("Chưa đạt")
Dòng cuối của thông báo lỗi:
SyntaxError: invalid syntax
Trộn Tab với dấu cách: TabError
Phím Tab chèn một ký tự Tab, còn phím cách chèn dấu cách. Trên màn hình hai cách thụt có thể trông như nhau, nhưng Python không đoán một Tab bằng mấy dấu cách. Dưới đây dòng 3 thụt bằng một Tab, dòng 4 bằng tám dấu cách:
diem = 8
if diem >= 5:
print("Đạt")
print("Được thưởng")
Dòng cuối của thông báo lỗi:
TabError: inconsistent use of tabs and spaces in indentation
Cách sửa lâu dài nằm ở trình soạn thảo. Trong VS Code, thanh trạng thái phía dưới ghi Spaces: 4 khi phím Tab chèn bốn dấu cách. Bấm vào đó để đổi, rồi chọn lệnh "Convert Indentation to Spaces" để đổi các Tab sẵn có trong file. Thụt bằng bốn dấu cách là quy ước của PEP 8, hướng dẫn viết code chuẩn của Python.
Kiểm tra nhanh
Thông báo
unindent does not match any outer indentation levelnghĩa là gì?- Một dòng thụt vào mà không nằm dưới dòng mở khối nào
- Một dòng lùi lề về một mức mà không dòng nào phía trên có
- Thân
ifbị bỏ trống
Thân một câu lệnh
ifchỉ có dòng# sẽ in lời khen sau. Những cách nào làm chương trình chạy được?- Thêm dòng
passdưới comment, thụt cùng mức với comment - Thay comment bằng một dòng
print("Giỏi")thụt vào - Thụt dòng comment sâu thêm bốn dấu cách
- Đổi dấu
#thành hai dấu##
- Thêm dòng
Trong khung bẫy lùi nhầm dòng ra sát lề, với
diem = 4, chương trình in gì?Được thưởng- Không in gì
- Báo lỗi
IndentationError
Bài tập
Xếp loại và cộng thưởng cho ba học viên
Lớp xét thưởng ba học viên Lan, Minh và Ngọc. Học viên có điểm từ 5 trở lên xếp loại "Đạt" và được cộng 50.000 đ thưởng, dưới 5 xếp loại "Chưa đạt" và không được thưởng. Dùng một câu lệnh if else cho mỗi học viên, thân if có hai dòng thụt cùng mức:
xep_loai_lan,xep_loai_minh,xep_loai_ngoc:"Đạt"hoặc"Chưa đạt".tong_thuong: tổng tiền thưởng của cả lớp, cộng dồn bằng+=trong thânif.
diem_lan = 5
diem_minh = 4.5
diem_ngoc = 9
xep_loai_lan = ""
xep_loai_minh = ""
xep_loai_ngoc = ""
tong_thuong = 0
# Viết code của bạn dưới dòng nàyTóm tắt
IndentationErrorvàTabErrorlà dạng riêng của lỗi cú pháp: Python báo khi đọc file, trước khi chạy.expected an indented blocklà thân khối trống hoặc sát lề; comment không tính là thân, dùngpasskhi chưa viết.unexpected indentlà một dòng thụt vào mà không thuộc khối nào.unindent does not match any outer indentation levellà dòng lùi về một mức không có ở phía trên.TabErrorđến từ việc trộn Tab với dấu cách; chỉnh trình soạn thảo để phím Tab chèn bốn dấu cách.Một dòng thân lùi ra sát lề không gây lỗi: nó chạy dù điều kiện đúng hay sai.
Câu hỏi thường gặp
Lỗi unexpected indent trong Python sửa thế nào?
Tìm dòng mà thông báo chỉ tới và xem dòng ngay trên nó. Nếu dòng trên không kết thúc bằng dấu hai chấm thì dòng này không được thụt sâu hơn, nên lùi nó về cùng mức với dòng trên. Lỗi hay đến từ đoạn code vừa dán. Luật thụt lề đầy đủ nằm ở bài cú pháp Python.
Lỗi TabError trong Python là gì, sao code trông thẳng hàng mà vẫn lỗi?
TabError nghĩa là một khối vừa có dòng thụt bằng ký tự Tab, vừa có dòng thụt bằng dấu cách. Trình soạn thảo vẽ một Tab rộng bằng vài dấu cách nên mắt thấy thẳng hàng, nhưng Python đọc từng ký tự. Đổi toàn bộ Tab trong file thành dấu cách là hết lỗi.
Thụt lề bao nhiêu dấu cách là đúng?
Python chỉ đòi các dòng trong cùng một thân thụt bằng nhau và sâu hơn dòng mở khối. Quy ước chung là bốn dấu cách mỗi mức, theo PEP 8. Dùng một mức chung cho cả file giúp tránh unindent does not match any outer indentation level. Ví dụ thân if, else lồng nhau có ở bài if lồng nhau.
Lỗi thụt lề có khác lỗi cú pháp thông thường không?
Cùng một họ: lỗi thụt lề là lỗi cú pháp về khoảng trắng đầu dòng. Cả hai chặn chương trình trước khi chạy dòng đầu tiên. Các lỗi cú pháp khác, như thiếu dấu hai chấm hay ngoặc chưa đóng, có bảng riêng ở trang SyntaxError.
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.