Bỏ qua đến nội dung chính
Mục lục

IndentationError, TabError trong Python: lỗi thụt lề

AIDev Team · duyệt: Nguyễn Việt Chung

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

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

expected an indented block after 'if' statement on line 2

dòng sau if ở dòng 2 không thụt vào

thụt thân if vào bốn dấu cách

IndentationError

expected an indented block after 'else' statement on line 4

thân else trống hoặc sát lề

thụt thân else vào

IndentationError

expected an indented block after 'for' statement on line 1

thân vòng lặp for sát lề

thụt thân for vào

IndentationError

expected an indented block after function definition on line 1

thân hàm def sát lề

thụt thân hàm vào

IndentationError

unexpected indent

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

unindent does not match any outer indentation level

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

inconsistent use of tabs and spaces in indentation

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

invalid syntax ở dòng else:

else thụt vào, không thẳng cột với if

đưa else về cùng mức với if

Đ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.

python
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:

python
diem = 8
if diem >= 5:
print("Đạt")

Dòng cuối của thông báo lỗi:

text
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:

python
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:

text
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ì:

python
diem = 8
if diem >= 5:
    pass  # sẽ in lời khen sau
print("Xong")

KẾT QUẢ

Xong

Thụ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:

python
ten = "Trần Thu Hà"
    print(ten)

Dòng cuối của thông báo lỗi:

text
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ó:

python
diem = 8
if diem >= 5:
        print("Đạt")
    print("Được thưởng")

Dòng cuối của thông báo lỗi:

text
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:

python
diem = 4
if diem >= 5:
    print("Đạt")
    else:
    print("Chưa đạt")

Dòng cuối của thông báo lỗi:

text
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:

python
diem = 8
if diem >= 5:
	print("Đạt")
        print("Được thưởng")

Dòng cuối của thông báo lỗi:

text
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

  1. Thông báo unindent does not match any outer indentation level nghĩ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 if bị bỏ trống
  2. Thân một câu lệnh if chỉ 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 pass dướ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 ##
  3. 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
Đúng hết lần đầu +15 XP

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ân if.

python
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ày

Tóm tắt

  • IndentationError và TabError là 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 block là thân khối trống hoặc sát lề; comment không tính là thân, dùng pass khi chưa viết.

  • unexpected indent là một dòng thụt vào mà không thuộc khối nào.

  • unindent does not match any outer indentation level là 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ủ đề

indentationerror

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

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.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập