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

NameError: name is not defined trong Python và cách sửa

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

Bài 3/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

Thông báo NameError: name 'tong' is not defined trong Python nghĩa là chương trình dùng một cái tên mà tới dòng đó Python chưa thấy được gán ở đâu. Bạn gặp nó khi gõ sai một chữ của tên biến, dùng biến trước dòng gán nó, quên dấu nháy quanh một chuỗi, hay gọi một module mà quên dòng import.

Cần biết trước: biến, quy tắc đặt tên biến và True, False.

Bảng tra nhanh: các dạng name is not defined

Python gọi lỗi này là NameError. Tên trong dấu nháy đơn của thông báo là tên Python không tìm thấy, và đó là chỗ bạn nhìn vào trước. Cột "Thông báo" ghi phần sau NameError: mà Python 3.12, 3.13 và 3.14 in giống nhau khi bạn chạy trên máy.

Thông báo

Nguyên nhân

Cách sửa

name 'tong_tein' is not defined. Did you mean: 'tong_tien'?

gõ sai chữ trong tên biến

viết đúng tên mà Python gợi ý (trên máy)

name 'Ten' is not defined. Did you mean: 'ten'?

sai chữ hoa, chữ thường

Ten và ten là hai tên khác nhau

name 'true' is not defined. Did you mean: 'True'?

viết thường True, False, None

viết hoa chữ đầu

name 'Print' is not defined. Did you mean: 'print'?

viết hoa tên hàm có sẵn

print, len, input viết thường

name 'tong' is not defined

dùng biến trước dòng gán nó

đặt dòng gán lên trước

name 'Huế' is not defined

chuỗi quên dấu nháy

"Huế"

name 'math' is not defined. Did you forget to import 'math'?

dùng module chưa import

thêm import math ở đầu file

name 'null' is not defined

chép thói quen của ngôn ngữ khác

Python viết là None

name 'raw_input' is not defined

code viết cho Python 2

dùng input()

Câu Did you mean là Python đoán một tên gần giống trong số tên đã có. Chạy đoạn dưới: mỗi dòng gán là cách sửa của một hàng trong bảng.

python
tong_tien = 96000
ten = "Lê Minh Tâm"
dang_mo = True
thanh_pho = "Huế"
print(ten, thanh_pho, tong_tien, dang_mo)

KẾT QUẢ

Lê Minh Tâm Huế 96000 True

Đổi print(ten, thanh_pho, tong_tien, dang_mo) thành print(ten, thanh_pho, tong_tein, dang_mo) rồi chạy lại: Python in name 'tong_tein' is not defined. Trên trang, dòng thông báo kết thúc ngay ở chữ defined: nút Chạy không in câu Did you mean, còn Python trên máy của bạn thì in. Cách gán và gán lại biến nằm ở bài biến, còn True, False ở bài boolean, bài mẹ của trang này.

Nguyên nhân 1: gõ sai tên, sai chữ hoa chữ thường

Python phân biệt từng chữ của tên, kể cả hoa với thường. Chỉ cần đảo hai chữ cái là ra một tên Python chưa từng thấy:

python
tong_tien = 96000
print(tong_tein)

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

text
NameError: name 'tong_tein' is not defined. Did you mean: 'tong_tien'?

True, False và None cũng là tên, viết hoa chữ đầu. Người quen ngôn ngữ khác hay viết true:

python
dang_mo = true

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

text
NameError: name 'true' is not defined. Did you mean: 'True'?

Tên đặt theo một kiểu chung, như snake_case toàn chữ thường, giúp bạn ít gõ sai. Python không đoán được khi tên gõ sai khác tên đúng quá nhiều, như lenght với len: thông báo khi đó chỉ có name 'lenght' is not defined.

Nguyên nhân 2: dùng biến trước khi gán

Python chạy từ trên xuống. Một tên chỉ có từ lúc dòng gán nó chạy xong, nên dòng dùng nằm trên dòng gán thì báo lỗi:

python
print(tong)
tong = 96000

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

text
NameError: name 'tong' is not defined

Dòng tong += 29000 cũng đọc giá trị cũ của tong trước khi cộng, nên báo đúng lỗi này khi tong chưa từng được gán. Biến cộng dồn cần một dòng gán ban đầu:

python
tong = 0
tong += 29000
tong += 32000
print(tong)

KẾT QUẢ

61000

Nguyên nhân 3: quên dấu nháy quanh chuỗi

Không có dấu nháy, Python đọc chữ như một tên biến, kể cả chữ có dấu tiếng Việt:

python
thanh_pho = Huế

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

text
NameError: name 'Huế' is not defined

Có nháy là chữ, không nháy là tên. Đoạn dưới dùng cả hai:

python
bac_xiu = 32000
mon = "bac_xiu"
print(mon, bac_xiu)

KẾT QUẢ

bac_xiu 32000

mon giữ đúng bảy ký tự trong nháy, còn bac_xiu không nháy là tên của biến giữ giá 32000. Chữ có khoảng trắng, như bạc xỉu không nháy, lại báo lỗi cú pháp, vì hai tên đứng cạnh nhau không thành câu lệnh.

Nguyên nhân 4: quên import, hoặc tên nằm trong hàm khác

Module như math chỉ có tên sau dòng import. Bài import dạy cách lấy một module có sẵn của Python:

python
print(math.sqrt(16))

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

text
NameError: name 'math' is not defined. Did you forget to import 'math'?

Câu Did you forget to import 'math'? có từ Python 3.12 và trên trang vẫn hiện đủ. Cách sửa là thêm import math lên dòng đầu file. Một biến gán bên trong hàm tự viết chỉ có tên bên trong hàm đó, nên đọc nó ở ngoài hàm cũng báo name … is not defined. Bài phạm vi biến giải thích luật này. Hàm gán vào một biến rồi đọc nó trước dòng gán thì báo UnboundLocalError, một loại NameError riêng: cannot access local variable 'so_khach' where it is not associated with a value.

Kiểm tra nhanh

  1. Chạy riêng từng dòng, những dòng nào báo NameError?

    • dang_mo = true
    • mon = "bac_xiu"
    • thanh_pho = Huế
    • So_ly = 2
  2. Sau dòng tong_tien = 96000, lệnh print(tong_tein) báo lỗi gì?

    • In ra 96000
    • Báo lỗi SyntaxError
    • Báo lỗi NameError
  3. Trong khung bẫy gán vào tên gõ sai, dòng cuối in gì?

    • 96000
    • 100000
    • Báo lỗi NameError
Đúng hết lần đầu +15 XP

Bài tập

Sửa bốn dòng báo NameError

Bốn dòng trong comment của starter là đơn đặt trà của quán, mỗi dòng báo NameError khi bỏ dấu #. Viết lại từng dòng cho đúng, giữ nguyên phép tính:

  • con_mo: quán đang mở, giá trị True.

  • thanh_pho: chuỗi Huế.

  • tong_tien: giá một ly nhân số ly đặt.

  • duoc_giam: True khi tổng tiền từ NGUONG_GIAM trở lên và quán đang mở.

python
# con_mo = true
# thanh_pho = Huế
# tong_tien = gia_ly * so_ly_dta
# duoc_giam = tong_tien >= NGUONG_GIAM and Con_mo
gia_ly = 29000
so_ly_dat = 2
NGUONG_GIAM = 58000
con_mo = False
thanh_pho = ""
tong_tien = 0
duoc_giam = False
# Viết code của bạn dưới dòng này

Tóm tắt

  • name '...' is not defined nghĩa là tới dòng đó Python chưa thấy tên trong nháy được gán.

  • Gõ sai chữ hay sai hoa thường là nguyên nhân hay gặp; True, False, None viết hoa chữ đầu.

  • Dòng dùng biến phải nằm sau dòng gán nó; biến cộng dồn cần giá trị ban đầu.

  • Chữ không có nháy là tên biến; muốn chữ thì thêm dấu nháy.

  • Dùng module mà thiếu import cũng báo lỗi này, kèm câu Did you forget to import.

  • Gán vào tên gõ sai không báo lỗi mà tạo biến mới; trên trang, thông báo không có câu Did you mean.

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

Lỗi NameError là gì trong Python?

Đó là lỗi Python báo khi chạy tới một tên chưa từng được gán, dù là tên biến, tên hàm hay tên module. Lỗi xảy ra lúc chạy, nên các dòng phía trên dòng lỗi đã chạy xong. Cách gán một tên và đọc lại nó nằm ở bài biến.

Vì sao trên máy Python gợi ý Did you mean mà trên trang thì không?

Câu gợi ý do phần in thông báo của Python tính thêm, bằng cách dò các tên đang có. Nút Chạy của trang dựng thông báo theo cách riêng và không thêm câu đó, nên bạn chỉ thấy phần trước dấu chấm. Câu Did you forget to import của module thì trên trang vẫn hiện đủ.

Sao code chép từ mạng báo name 'raw_input' is not defined?

raw_input() là hàm đọc bàn phím của Python 2, Python 3 đổi tên nó thành input(). Code chép về còn dùng tên cũ thì đổi sang input(), như bài input() hướng dẫn. Tương tự, print "..." kiểu Python 2 là lỗi cú pháp, có ở trang SyntaxError.

Đặt tên biến trùng tên hàm có sẵn có gây NameError không?

Không, nhưng gây lỗi khác về sau. Gán print = 5 làm tên print trỏ tới số 5, nên lời gọi print() sau đó báo TypeError. Bài đặt tên biến liệt kê các tên nên tránh.

Chủ đề

nameerror

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