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

ValueError: invalid literal for int() trong Python

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

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

Thông báo ValueError: invalid literal for int() with base 10: 'hai' trong Python nghĩa là int() nhận đúng một chuỗi nhưng chuỗi đó không viết được thành số nguyên. Bạn gặp nó khi người dùng gõ chữ thay cho số, gõ số có phần thập phân, bỏ trống ô nhập, hay gõ kèm dấu chấm ngăn hàng nghìn như 29.000.

Cần biết trước: ép kiểu và input().

Bảng tra nhanh: thông báo ValueError và cách sửa

Python gọi lỗi này là ValueError: kiểu của giá trị đúng, nội dung thì sai. Chuỗi cuối thông báo, trong nháy đơn, là đúng chuỗi mà hàm nhận được, kể cả dấu cách và chuỗi rỗng ''. Cột "Thông báo" ghi phần sau ValueError:, giống nhau trên Python 3.12, 3.13, 3.14 và trên trang, trừ hàng có ghi rõ phiên bản.

Thông báo

Nguyên nhân

Cách sửa

invalid literal for int() with base 10: 'hai'

chuỗi là chữ, không phải chữ số

yêu cầu người dùng gõ chữ số

invalid literal for int() with base 10: '8.5'

chuỗi có phần thập phân

float(), hoặc int(float(...)) nếu cần số nguyên

invalid literal for int() with base 10: ''

người dùng bỏ trống, chỉ nhấn Enter

hỏi lại cho tới khi có giá trị

invalid literal for int() with base 10: '29.000'

dấu chấm ngăn hàng nghìn kiểu Việt Nam

gõ 29000

invalid literal for int() with base 10: '29000đ'

chuỗi dính đơn vị tiền

bỏ chữ đ trước khi đổi

could not convert string to float: '8,5'

dấu phẩy thập phân kiểu Việt Nam

gõ dấu chấm, 8.5

could not convert string to float: ''

chuỗi rỗng

hỏi lại

not enough values to unpack (expected 3, got 2)

gán ba tên từ hai giá trị

đủ giá trị cho từng tên

too many values to unpack (expected 2, got 3) (3.14), too many values to unpack (expected 2) (3.12, 3.13)

gán hai tên từ ba giá trị

thêm tên, hoặc bớt giá trị

list.remove(x): x not in list

xóa phần tử không có trong list

kiểm tra bằng in trước

list.index(x): x not in list (3.14), 'cà phê' is not in list (3.12, 3.13)

tìm vị trí của giá trị không có trong list

kiểm tra bằng in trước

substring not found

index() trên chuỗi không thấy chuỗi con

dùng find(), trả -1 khi không thấy

time data '2026-11-15' does not match format '%d/%m/%Y'

chuỗi ngày không khớp mẫu của strptime()

sửa mẫu cho khớp chuỗi

expected a nonnegative input, got -4.0 (3.14), math domain error (3.12, 3.13)

căn bậc hai của số âm bằng math.sqrt()

kiểm tra dấu trước

Hai hàng cuối thuộc các bài ngày giờ và module math. Đoạn dưới cho thấy int() và float() chấp nhận những gì: dấu cách thừa ở hai đầu, dấu + và dấu - đều không sao.

python
print(int(" 3 "), int("+3"), int("-3"))
print(float(" 2.5\n"), float("8.5"))

KẾT QUẢ

3 3 -3
2.5 8.5

Đổi int(" 3 ") thành int("ba") rồi chạy lại: Python in invalid literal for int() with base 10: 'ba'. Chuỗi "ba" là chữ, nên dù nghĩa là số 3, int() vẫn không đổi được. Bài input(), bài mẹ của trang này, giải thích vì sao giá trị gõ vào là chuỗi.

invalid literal for int() with base 10: chuỗi không phải số nguyên

base 10 nghĩa là hệ thập phân, cách viết số thông thường. int() chỉ nhận chuỗi gồm các chữ số, có thể kèm dấu cách hai đầu và một dấu + hoặc - ở trước. Chuỗi khác thì báo lỗi:

python
so_ly = int("hai")

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

text
ValueError: invalid literal for int() with base 10: 'hai'

Trong chương trình thật, chuỗi đến từ input(): dòng so_ly = int(input("Số ly: ")) gặp người gõ hai báo đúng thông báo trên, với 'hai' ở cuối. Ô nhập bỏ trống cho chuỗi rỗng:

python
so_ly = int("")

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

text
ValueError: invalid literal for int() with base 10: ''

Hai dấu nháy liền nhau ở cuối là dấu hiệu người dùng chỉ nhấn Enter. Người Việt hay viết 29.000 cho hai mươi chín nghìn, nhưng với Python dấu chấm là dấu thập phân:

python
gia = int("29.000")

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

text
ValueError: invalid literal for int() with base 10: '29.000'

Chuỗi số thực: int("8.5") và could not convert string to float

Chuỗi có phần thập phân không đổi thẳng bằng int() được, dù int(8.5) trên một số thực thì chạy:

python
diem = int("8.5")

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

text
ValueError: invalid literal for int() with base 10: '8.5'

Cách sửa là đổi sang số thực trước, rồi mới lấy phần nguyên:

python
diem = int(float("8.5"))
print(diem)
print(int(float("12.0")))

KẾT QUẢ

8
12

float() lại báo lỗi với dấu phẩy thập phân, cách viết quen của người Việt:

python
can_nang = float("8,5")

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

text
ValueError: could not convert string to float: '8,5'

Dòng hướng dẫn bên cạnh ô nhập nên ghi rõ "dùng dấu chấm, như 8.5".

Kiểm tra trước hay bắt lỗi để người dùng nhập lại

Có hai cách giữ chương trình chạy tiếp khi người dùng gõ sai. Cách đầu là kiểm tra chuỗi trước khi đổi, bằng phương thức isdigit(): "29000".isdigit() là True, "8.5".isdigit() là False. Phương thức này khắt khe hơn int() ở chỗ trả False cho " 3" và "-3", nhưng lại trả True cho chữ số nhỏ "²" mà int() từ chối. Cách thứ hai là cứ đổi, gặp lỗi thì hỏi lại, bằng try except.

Hai thông báo khác cũng thuộc ValueError mà người mới hay gặp. Gán nhiều tên cùng lúc mà số giá trị không khớp, bài unpacking dạy cách này:

python
ten, tuoi = "Lan", 17, "10A1"

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

text
ValueError: too many values to unpack (expected 2, got 3)

Python 3.12 và 3.13 in ngắn hơn, không có phần got 3. Xóa một phần tử không có trong list bằng remove() báo list.remove(x): x not in list. Tìm vị trí của nó bằng index() cũng báo ValueError:

python
mon = ["trà đào", "bạc xỉu"]
print(mon.index("cà phê"))

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

text
ValueError: list.index(x): x not in list

Python 3.12 và 3.13 in 'cà phê' is not in list. Trên chuỗi, "DH1024".index("X") báo substring not found, còn find() trả -1, như bài find(), index(), count() chỉ.

Một lỗi khác là dạng riêng của ValueError: json.loads() gặp chuỗi không phải JSON báo JSONDecodeError. Code của bạn cũng tự báo được ValueError, như raise ValueError("so_ly phải lớn hơn 0") của bài raise.

Kiểm tra nhanh

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

    • int("8.5")
    • int(" 3 ")
    • int("")
    • float("8.5")
  2. Dòng float("8,5") báo thông báo nào?

    • invalid literal for int() with base 10: '8,5'
    • Không báo lỗi, in 8.5
    • could not convert string to float: '8,5'
  3. Trong khung bẫy, print(int(float("8.9"))) in gì?

    • 8
    • 9
    • Báo lỗi ValueError
Đúng hết lần đầu +15 XP

Bài tập

Đổi các chuỗi của một đơn hàng sang số

Ba giá trị của một đơn hàng đọc từ form nên đều là chuỗi: số ly còn dính dấu cách thừa, cân nặng kiện hàng có phần thập phân. Dòng trong comment của starter báo ValueError. Viết các dòng gán:

  • so_ly: số ly, một số nguyên, đổi bằng int().

  • so_kg: số kg chẵn để tính phí giao, bỏ phần lẻ chứ không làm tròn, đổi bằng float() rồi int().

  • tong: giá một ly nhân số ly, là số nguyên.

Không gõ thẳng đáp số vào code.

python
# so_kg = int(can_nang_chu)
so_ly_chu = "  3 "
can_nang_chu = "12.8"
gia_chu = "29000"
so_ly = 0
so_kg = 0
tong = 0
# Viết code của bạn dưới dòng này

Tóm tắt

  • ValueError là đúng kiểu nhưng sai nội dung: hàm nhận chuỗi, nhưng chuỗi đó không đổi được.

  • Chuỗi trong nháy cuối thông báo là đúng chuỗi hàm nhận được; '' là người dùng bỏ trống.

  • int() chịu dấu cách hai đầu và dấu +, -, không chịu phần thập phân, dấu chấm ngăn nghìn hay chữ.

  • Chuỗi số thực đổi bằng float(), số nguyên lấy bằng int(float(...)), và phần lẻ bị cắt chứ không làm tròn.

  • float() cần dấu chấm thập phân; 8,5 báo could not convert string to float.

  • Giữ chương trình chạy khi người dùng gõ sai bằng cách kiểm tra trước, hoặc bắt lỗi rồi hỏi lại.

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

Sửa lỗi invalid literal for int() with base 10 thế nào?

Đọc chuỗi ở cuối thông báo. Nếu là chữ hay chuỗi rỗng, người dùng gõ sai: kiểm tra trước hoặc hỏi lại. Nếu có phần thập phân như '8.5', đổi bằng float() trước. Nếu là '29.000' hay '29000đ', bỏ dấu chấm, chữ đơn vị trước khi đổi.

Lỗi ValueError là gì, khác TypeError chỗ nào?

ValueError là giá trị đúng kiểu mà sai nội dung: int("hai") nhận một chuỗi đúng như hàm cần, nhưng chuỗi đó không phải số. TypeError là sai kiểu ngay từ đầu, như int(None) hay cộng chuỗi với số. Hai lỗi có cách sửa khác nhau.

Làm sao bắt ValueError để người dùng nhập lại?

Dùng try except quanh dòng đổi kiểu, đặt trong một vòng lặp hỏi lại cho tới khi chuỗi đổi được. Bài đó dạy đầy đủ cách viết này.

Vì sao chuỗi isdigit() trả True mà int() vẫn báo lỗi?

isdigit() coi chữ số nhỏ như "²" là chữ số, còn int() thì không nhận. Ngược lại, " 3" có dấu cách làm isdigit() trả False dù int() đổi được. Kiểm tra bằng isdigit() vì vậy không thay hẳn được việc bắt lỗi, các bài phương thức chuỗi và ép kiểu có thêm ví dụ.

Chủ đề

valueerror

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