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

SyntaxError trong Python: nghĩa là gì và cách sửa

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

Bài 1/13 · Chương 24

Giải nghĩa thông báo lỗi

  • 10 phút
  • Cơ bản
  • Python 3.14
  • Cập nhật

Lỗi cú pháp trong Python, dòng cuối mở bằng SyntaxError:, nghĩa là Python đọc file của bạn và gặp một chỗ viết sai luật viết code nên dừng lại trước khi chạy bất kỳ dòng nào. Bạn hay gặp nó ngay sau khi gõ hay dán code: quên dấu hai chấm, quên đóng ngoặc, để dấu nháy lệch nhau, hoặc chép nhầm dấu nháy cong từ một tài liệu.

Cần biết trước: cú pháp Python và chuỗi.

Bảng tra nhanh: các thông báo lỗi cú pháp hay gặp

Mỗi hàng là một thông báo SyntaxError, viết đúng phần sau chữ SyntaxError: mà Python 3.12 đến 3.14 in ra (một hàng khác theo bản). Chạy dòng ở cột "Dòng gây lỗi" là thấy đúng thông báo đó.

Thông báo

Nguyên nhân

Dòng gây lỗi

Cách sửa

expected ':'

dòng mở khối thiếu dấu hai chấm

if diem >= 5

thêm : cuối dòng

'(' was never closed

mở ngoặc mà không đóng

print("Tổng:", 96000

thêm )

unmatched ')'

thừa một ngoặc đóng

print("Tổng:", 96000))

bỏ ) thừa

closing parenthesis ']' does not match opening parenthesis '('

đóng nhầm loại ngoặc

print("Tổng:", 96000]

đóng bằng )

unterminated string literal (detected at line 1)

chuỗi thiếu nháy đóng, hoặc đóng bằng loại nháy khác

ten = 'Lê Minh Tâm"

đóng bằng đúng loại nháy đã mở

unterminated triple-quoted string literal (detected at line 1)

chuỗi ba nháy chưa đóng tới cuối file

loi_chao = """Lê Minh Tâm

thêm """ ở cuối chuỗi

invalid syntax. Is this intended to be part of the string? (3.14), invalid syntax (3.12, 3.13)

nháy bên trong trùng loại nháy bọc ngoài

ten_quan = "Quán "Góc Phố""

đổi nháy bọc ngoài thành '

invalid syntax. Perhaps you forgot a comma?

thiếu dấu phẩy giữa hai giá trị

print("Tổng:" 96000)

thêm ,

Missing parentheses in call to 'print'. Did you mean print(...)?

viết print kiểu Python 2

print "Xin chào"

print("Xin chào")

invalid character '“' (U+201C)

dấu nháy cong chép từ Word, Zalo, trang web

print(“Xin chào”)

gõ lại bằng nháy thẳng "

invalid syntax. Maybe you meant '==' or ':=' instead of '='?

so sánh bằng một dấu =

if diem = 5:

viết ==

cannot assign to expression here. Maybe you meant '==' instead of '='?

gán vào một phép tính

diem + 1 = 5

viết ==

leading zeros in decimal integer literals are not permitted; use an 0o prefix for octal integers

số nguyên viết số 0 ở đầu

gio = 07

bỏ số 0, viết 7

'break' outside loop, 'return' outside function

break nằm ngoài vòng lặp, return nằm ngoài hàm

break / return 5

đưa lệnh vào trong vòng lặp hoặc hàm

invalid decimal literal

tên biến bắt đầu bằng chữ số

2ly = 58000

đổi tên, như hai_ly

invalid syntax

dùng từ khóa làm tên biến, hoặc chép cả dấu nhắc >>>

class = "10A1"

đổi tên, như lop

Chạy đoạn dưới: mỗi dòng là cách sửa của một hàng trong bảng, và cả chương trình chạy hết.

python
diem = 8
if diem >= 5:
    print("Đạt")
print("Tổng:", 96000)
ten = 'Lê Minh Tâm'
ten_quan = 'Quán "Góc Phố"'
print(ten, ten_quan)
print("Xin chào")
hai_ly = 58000
lop = "10A1"
print(hai_ly, lop)

KẾT QUẢ

Đạt
Tổng: 96000
Lê Minh Tâm Quán "Góc Phố"
Xin chào
58000 10A1

Đổi if diem >= 5: thành if diem >= 5 rồi chạy lại: Python in SyntaxError: expected ':' và không chạy dòng nào. Python kiểm cú pháp cả chương trình trước khi chạy, nên một chỗ sai ở dòng 2 chặn cả dòng 4.

Đọc số dòng và mũi tên ^ chỉ chỗ lỗi

Trên máy của bạn, lỗi cú pháp in ba phần: tên file kèm số dòng, chính dòng đó, và một dòng có dấu ^ đặt dưới chỗ Python phát hiện ra lỗi. Lưu ba dòng sau thành file main.py:

python
print("Bắt đầu")
print("Tổng:", 96000
print("Xong")

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

text
SyntaxError: '(' was never closed

Chạy trong terminal (trên Windows gõ python thay cho python3). Kết quả dưới đây chạy bằng Docker image python:3.14-slim, file nằm ở thư mục /app:

bash
python3 main.py

KẾT QUẢ

  File "/app/main.py", line 2
    print("Tổng:", 96000
         ^
SyntaxError: '(' was never closed

Dòng Bắt đầu không được in. Mũi tên nằm dưới dấu ( mở ở dòng 2, dù Python phải đọc tới hết file mới chắc ngoặc không được đóng: trong ngoặc, một câu lệnh được viết tiếp sang dòng sau.

python
print("Cà phê sữa", 29000,
      "Bạc xỉu", 32000)

KẾT QUẢ

Cà phê sữa 29000 Bạc xỉu 32000

Khối lỗi trên trang chỉ cho thấy dòng cuối. Khi bạn làm lời mời thử ở bảng tra nhanh, ô kết quả của nút Chạy in đủ ba phần như trên, tên file là main.py, và dòng trạng thái ghi Dòng 2: SyntaxError: expected ':'.

Mũi tên chỉ chỗ Python nhận ra lỗi, còn chỗ sai thật có thể nằm ngay trước nó. Với if diem >= 5 thiếu dấu hai chấm, mũi tên nằm sau số 5, ở cuối dòng, vì tới đó Python mới biết dòng kết thúc mà chưa có :.

Thiếu dấu hai chấm hay sai ngoặc

Dòng mở khối nào cũng kết thúc bằng dấu hai chấm: dòng if của câu lệnh điều kiện, dòng else, dòng for, và dòng def khi bạn tự viết hàm. Thiếu nó ở dòng def cũng ra đúng một thông báo:

python
def chao()
    print("Xin chào")

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

text
SyntaxError: expected ':'

Với ngoặc, Python phân biệt ba thông báo: ngoặc mở không đóng ('(' was never closed), ngoặc đóng thừa (unmatched ')'), và ngoặc đóng khác loại với ngoặc mở. Ví dụ đóng ( bằng ]:

python
print("Tổng:", 96000]

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

text
SyntaxError: closing parenthesis ']' does not match opening parenthesis '('

Dòng có nhiều cặp ngoặc lồng nhau thì đếm từ trái sang: mỗi ( cần đúng một ).

Dấu nháy lệch và chuỗi chưa đóng

Chuỗi mở bằng loại nháy nào thì đóng bằng đúng loại đó. Mở bằng ' mà đóng bằng " thì Python coi chuỗi chưa đóng tới hết dòng:

python
ten = 'Lê Minh Tâm"

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

text
SyntaxError: unterminated string literal (detected at line 1)

Trường hợp ngược lại: chuỗi bọc bằng nháy kép mà bên trong cũng có nháy kép. Python đóng chuỗi ở dấu nháy thứ hai, phần còn lại thành code vô nghĩa:

python
ten_quan = "Quán "Góc Phố""

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

text
SyntaxError: invalid syntax. Is this intended to be part of the string?

Python 3.13 trở về trước in SyntaxError: invalid syntax. Cách sửa là chọn nháy bọc ngoài khác loại với nháy bên trong:

python
ten_quan = 'Quán "Góc Phố"'
loi_nhan = "Tâm hỏi: 'Mấy giờ quán mở?'"
print(ten_quan)
print(loi_nhan)

KẾT QUẢ

Quán "Góc Phố"
Tâm hỏi: 'Mấy giờ quán mở?'

Chuỗi có cả hai loại nháy thì dùng chuỗi ba nháy, hoặc viết \" cho dấu nháy bên trong như bài ký tự escape hướng dẫn. Trong f-string, phần {} thiếu dấu đóng cũng là lỗi cú pháp, thông báo mở bằng chữ f-string:.

Gợi ý của Python: thiếu dấu phẩy, gõ sai từ khóa

Nhiều thông báo kèm sẵn một câu đoán cách sửa. Hai giá trị đặt cạnh nhau trong lời gọi hàm mà thiếu dấu phẩy:

python
print("Tổng:" 96000)

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

text
SyntaxError: invalid syntax. Perhaps you forgot a comma?

Từ Python 3.14, khi bạn gõ sai một từ khóa, Python đoán từ đúng:

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

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

text
SyntaxError: invalid syntax. Did you mean 'if'?

Python 3.13 trở về trước in SyntaxError: invalid syntax, không có câu đoán. Ở khối của bảng tra nhanh, đổi if diem >= 5: thành iff diem >= 5: rồi chạy lại: ô kết quả in Did you mean 'if'?. Dòng trạng thái bên dưới thì chỉ ghi Dòng 2: SyntaxError: invalid syntax. Gặp invalid syntax trơn, bạn đọc dòng có mũi tên, tìm từ gõ sai hay dấu phẩy bị thiếu.

Kiểm tra nhanh

  1. Những dòng nào khiến Python báo lỗi cú pháp ngay khi đọc file?

    • print "Xin chào"
    • loi_nhan = 'Tâm hỏi: "Mấy giờ quán mở?"'
    • ma_don = 'DH1024"
    • >>> print(ma_don)
  2. Một file có ba dòng: print("Bắt đầu"), print("Tổng:", 96000 và print("Xong"). Chạy file thì màn hình hiện gì?

    • Dòng Bắt đầu, rồi thông báo lỗi ở dòng 3
    • Dòng Bắt đầu, rồi thông báo lỗi ở dòng 2
    • Chỉ thông báo lỗi, mũi tên chỉ dấu ( ở dòng 2
  3. Bạn dán một dòng code từ tài liệu và nhận invalid character '“' (U+201C). Sửa thế nào?

    • Đổi chuỗi sang chuỗi ba nháy
    • Gõ lại hai dấu nháy bằng phím " trong trình soạn code
    • Thêm dấu \ trước dấu nháy
Đúng hết lần đầu +15 XP

Bài tập

Sửa ba dòng báo lỗi cú pháp

Ba dòng trong comment của starter báo SyntaxError khi bỏ dấu #. Viết lại từng dòng cho đúng, giữ nguyên chữ và số:

  • thong_bao: câu thông báo, giữ hai dấu nháy kép quanh tên quán.

  • mon, gia: tên món và giá, gia là số nguyên.

  • ma_don: mã đơn, không có dấu nháy nào bên trong.

  • kieu_gia: kiểu của gia, lấy bằng type().

python
# thong_bao = "Quán "Góc Phố" mở cửa lúc 7 giờ"
# mon, gia = "bạc xỉu" 32000
# ma_don = 'DH1024"
thong_bao = ""
mon = ""
gia = 0
ma_don = ""
kieu_gia = None
# Viết code của bạn dưới dòng này

Tóm tắt

  • Lỗi cú pháp chặn cả file: Python báo trước khi chạy dòng đầu tiên.

  • Số dòng và mũi tên ^ chỉ chỗ Python nhận ra lỗi; chỗ sai thật có thể nằm ngay trước mũi tên.

  • expected ':' là thiếu dấu hai chấm; ba thông báo về ngoặc phân biệt ngoặc chưa đóng, ngoặc thừa và ngoặc khác loại.

  • Nháy đóng phải cùng loại nháy mở; nháy bên trong phải khác loại nháy bọc ngoài.

  • invalid character và invalid non-printable character đến từ ký tự lạ khi dán code.

  • Python 3.14 thêm câu đoán từ khóa (Did you mean 'if'?); bản cũ hơn chỉ in invalid syntax.

Câu hỏi thường gặp

Lỗi invalid syntax trong Python là gì?

Đó là thông báo chung của lỗi cú pháp, khi Python không xếp được chỗ sai vào loại nào cụ thể hơn. Người mới hay gặp nó khi dùng từ khóa làm tên biến, gõ sai từ khóa, hoặc chép cả dấu nhắc >>>. Đọc dòng có mũi tên, rồi đối chiếu với quy tắc đặt tên biến và bảng tra nhanh của trang này.

Vì sao Python báo lỗi cú pháp mà không chạy dòng nào?

Trước khi chạy, Python đọc cả file và dịch nó sang dạng chạy được. Chỉ cần một dòng sai luật, việc dịch dừng lại, nên ngay cả dòng print() đầu tiên cũng không chạy. Lỗi xảy ra lúc chạy, như chia cho 0, thì khác: các dòng phía trên đã chạy xong. Bài ngoại lệ so sánh hai loại này.

Lỗi thụt lề có phải SyntaxError không?

Có, IndentationError là một dạng riêng của lỗi cú pháp, và TabError là dạng riêng của IndentationError. Chúng cũng chặn cả file trước khi chạy. Các thông báo như unexpected indent hay expected an indented block có trang riêng: IndentationError và TabError.

Sửa hết lỗi cú pháp rồi mà chương trình vẫn báo lỗi khác thì sao?

Đó là dấu hiệu tốt: file đã đúng luật viết, giờ Python chạy tới một dòng không làm được. Đọc tên lỗi ở dòng cuối, như NameError khi một tên chưa được gán, rồi mở trang của lỗi đó, chẳng hạn NameError.

Chủ đề

syntaxerror

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