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

IndexError: list index out of range trong Python

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

Bài 6/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 IndexError: list index out of range trong Python nghĩa là chương trình lấy một phần tử ở chỉ số mà list không có: list ba phần tử chỉ có chỉ số 0, 1, 2. Bạn gặp nó khi dùng chỉ số bằng độ dài list, khi vòng lặp range() chạy quá một lượt, khi đọc phần tử đầu của list rỗng, hay khi xóa phần tử trong lúc duyệt.

Cần biết trước: range(), list và append, pop, remove.

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

Python gọi lỗi này là IndexError. Các thông báo dưới đây giống hệt nhau trên Python 3.12, 3.13, 3.14 và trên trang. Thông báo không nêu chỉ số đã dùng, nên bạn đọc dòng mà nó chỉ tới rồi tự tính chỉ số đó.

Thông báo

Nguyên nhân

Cách sửa

list index out of range

chỉ số bằng hoặc lớn hơn len(ds)

chỉ số cuối là len(ds) - 1, hoặc ds[-1]

list index out of range

chỉ số âm vượt quá, như ds[-4] với ba phần tử

chỉ số âm nhỏ nhất là -len(ds)

list index out of range

ds[0] khi list rỗng

kiểm tra len(ds) > 0 trước

list index out of range

range(len(ds) + 1) hoặc range(1, len(ds) + 1)

range(len(ds))

list index out of range

đọc ds[i + 1] ở lượt cuối của range(len(ds))

range(len(ds) - 1)

list index out of range

pop(i) trong vòng lặp theo chỉ số làm list ngắn đi

tạo list mới thay cho xóa

list assignment index out of range

gán ds[i] = x vào chỉ số chưa có

ds.append(x)

pop from empty list

pop() trên list rỗng

kiểm tra list trước

pop index out of range

pop(i) với chỉ số không có

chỉ số trong khoảng 0 tới len(ds) - 1

string index out of range

chỉ số vượt khỏi chuỗi

như với list

tuple index out of range

chỉ số vượt khỏi tuple

như với list

Cắt list thì không bao giờ báo lỗi này: ds[1:10] chỉ lấy những phần tử có thật. Chạy đoạn dưới để thấy các chỉ số hợp lệ của một list ba phần tử:

python
hoc_vien = ["Lan", "Minh", "Ngọc"]
print(hoc_vien[0], hoc_vien[2], hoc_vien[-1])
print(hoc_vien[len(hoc_vien) - 1])
print(hoc_vien[1:10], hoc_vien[5:])

KẾT QUẢ

Lan Ngọc Ngọc
Ngọc
['Minh', 'Ngọc'] []

Đổi hoc_vien[2] thành hoc_vien[3] rồi chạy lại: Python in list index out of range. Bài mẹ của trang này, bài append, pop, remove, dạy các cách làm list dài ra và ngắn đi.

Chỉ số bằng độ dài list

Chỉ số bắt đầu từ 0, nên phần tử cuối có chỉ số len(ds) - 1. Dùng chính len(ds) làm chỉ số là nguyên nhân hay gặp:

python
hoc_vien = ["Lan", "Minh", "Ngọc"]
print(hoc_vien[3])

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

text
IndexError: list index out of range

Cần phần tử cuối thì viết hoc_vien[-1]: chỉ số âm đếm từ cuối và không phụ thuộc độ dài. List rỗng không có phần tử nào, kể cả phần tử đầu:

python
viec = []
print(viec[0])

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

text
IndexError: list index out of range

Kiểm tra độ dài trước khi đọc:

python
viec = []
if len(viec) > 0:
    print(viec[0])
else:
    print("Chưa có việc nào")

KẾT QUẢ

Chưa có việc nào

Vòng lặp chạy quá phần tử cuối

range(len(ds)) cho đúng các chỉ số từ 0 tới len(ds) - 1. Cộng thêm 1 vào độ dài là chạy quá một lượt. Chương trình in hết ba điểm rồi mới dừng ở lượt thứ tư:

python
diem = [7, 9, 4]
for i in range(len(diem) + 1):
    print(diem[i])

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

text
IndexError: list index out of range

Viết range(1, len(diem) + 1) cho quen cách đếm từ một cũng báo đúng lỗi này ở lượt cuối. Một tình huống khó thấy hơn là so sánh phần tử với phần tử đứng sau nó. Ở lượt cuối, diem[i + 1] đã nằm ngoài list, nên vòng lặp phải dừng sớm một lượt:

python
diem = [7, 9, 4, 8]
for i in range(len(diem) - 1):
    print(diem[i], "->", diem[i + 1])

KẾT QUẢ

7 -> 9
9 -> 4
4 -> 8

Xóa phần tử bằng pop(i) trong một vòng lặp theo chỉ số cũng báo list index out of range, vì list ngắn đi mà range() đã tính sẵn độ dài cũ. Cách an toàn là tạo một list mới chứa các phần tử muốn giữ.

List rỗng và gán ngoài độ dài: pop from empty list, list assignment index out of range

pop() lấy phần tử cuối ra, nên list rỗng không còn gì để lấy:

python
viec = []
viec.pop()

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

text
IndexError: pop from empty list

Lỗi này hay gặp khi dùng list như một chồng đĩa, bài stack chỉ cách kiểm tra chồng còn phần tử trước khi lấy. Gán vào một chỉ số chưa có cũng không làm list dài ra:

python
diem = []
diem[0] = 8

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

text
IndexError: list assignment index out of range

Thêm phần tử mới bằng diem.append(8). Phép gán ds[i] = x chỉ sửa phần tử đã có. Chuỗi báo string index out of range theo đúng luật đó: "Lan"[3] vượt khỏi ba ký tự.

Kiểm tra nhanh

  1. Với ds = ["a", "b", "c"], những biểu thức nào báo IndexError?

    • ds[3]
    • ds[-3]
    • ds[1:5]
    • ds[-4]
  2. Với diem = [7, 9, 4], vòng for i in range(len(diem) + 1): print(diem[i]) làm gì?

    • Báo lỗi ngay, không in gì
    • In 7, 9, 4 rồi báo list index out of range
    • In 7, 9, 4 và chạy xong
  3. Trong khung bẫy bắt đầu từ 1, chương trình in gì?

    • 13
    • 20
    • Báo lỗi IndexError
Đúng hết lần đầu +15 XP

Bài tập

Đếm số lần điểm tăng so với bài trước

diem là điểm các bài kiểm tra của Lan theo thứ tự thời gian. Dòng trong comment của starter đếm số lần điểm tăng nhưng báo IndexError. Viết lại cho đúng:

  • so_lan_tang: số lần một bài có điểm cao hơn hẳn bài ngay trước nó, đếm bằng vòng for trên range() và len().

  • diem_cuoi: điểm bài gần nhất, lấy từ list.

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

python
# for i in range(len(diem)): (nếu diem[i + 1] > diem[i] thì cộng 1)
diem = [8, 9, 9, 4, 8, 5, 7]
so_lan_tang = 0
diem_cuoi = 0
# Viết code của bạn dưới dòng này

Tóm tắt

  • list index out of range nghĩa là chỉ số nằm ngoài khoảng 0 tới len(ds) - 1, hoặc âm quá -len(ds).

  • Phần tử cuối là ds[-1] hay ds[len(ds) - 1]; ds[len(ds)] đã vượt khỏi list.

  • range(len(ds)) cho đúng các chỉ số; so sánh với phần tử sau thì dùng range(len(ds) - 1).

  • List rỗng không có ds[0] và không pop() được: kiểm tra độ dài trước.

  • Gán vào chỉ số chưa có báo list assignment index out of range; thêm phần tử bằng append().

  • Bắt đầu vòng lặp từ 1 không báo lỗi nhưng bỏ mất phần tử đầu.

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

Sửa lỗi list index out of range trong vòng lặp thế nào?

In i và len(ds) ngay trước dòng lỗi để thấy lượt nào vượt. Thường thì range() được cộng thêm 1, hoặc thân vòng lặp đọc ds[i + 1]. Nếu chỉ cần từng phần tử mà không cần chỉ số, viết for x in ds: thay cho duyệt theo chỉ số, cách bài duyệt list hướng dẫn.

Vì sao ds[1:10] không báo IndexError mà ds[10] thì có?

Phép cắt trả về một list con gồm các phần tử có thật trong khoảng đó, khoảng vượt quá thì list con ngắn hơn hoặc rỗng. Lấy một phần tử thì phần tử đó phải tồn tại. Luật cắt đầy đủ nằm ở bài cắt chuỗi.

Lỗi IndexError khác KeyError chỗ nào?

IndexError là chỉ số vượt khỏi một dãy có thứ tự như list, chuỗi, tuple. KeyError là tra một khóa không có trong dict. Cả hai báo khi bạn đọc một vị trí không tồn tại, nhưng cách sửa khác nhau.

Làm sao biết list có rỗng không trước khi đọc phần tử đầu?

So len(ds) với 0 trong một câu lệnh if, như ví dụ viec ở mục chỉ số bằng độ dài. Đọc ds[0] chỉ trong nhánh len(ds) > 0, nhánh còn lại in một lời báo. Bài list có thêm ví dụ về list rỗng.

Chủ đề

list index out of range

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