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

Length of values does not match length of index: cách sửa

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

Bài 4/13 · Chương 10

Giải nghĩa lỗi và cảnh báo

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

Thông báo ValueError: Length of values (2) does not match length of index (3) nghĩa là bạn gán một list hai phần tử vào cột của một bảng ba dòng. Số đầu là độ dài của list bạn đưa vào, số sau là số dòng của bảng; pandas không tự đoán phần tử nào thuộc dòng nào khi hai số lệch nhau.

Cần biết trước: thêm cột trong pandas và list trong Python.

Bảng tra nhanh: các dạng length mismatch trong pandas

Python gọi lỗi này là ValueError: kiểu dữ liệu đúng là list, nhưng số phần tử không hợp với bảng.

Thông báo

Nguyên nhân

Cách sửa

Length of values (2) does not match length of index (3)

list ngắn hơn số dòng

bổ sung phần tử, hay gán một giá trị đơn

Length of values (4) does not match length of index (3)

list dài hơn số dòng

bỏ phần tử thừa, xem lại nguồn của list

như trên, sau khi lọc bảng

list tính từ bảng đã lọc, gán vào bảng gốc

gán Series để pandas khớp theo index

Length mismatch: Expected axis has 2 elements, new values have 1 elements

gán df.columns một list thiếu tên

đưa đủ một tên cho mỗi cột

Lỗi thường gặp nhất là gõ tay một list và đếm thiếu:

python
import pandas as pd

don = pd.DataFrame({"ma_don": ["DH1024", "DH1025", "DH1026"]})
don["phi_giao"] = [30000, 0]

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

text
ValueError: Length of values (2) does not match length of index (3)

Kiểm độ dài bằng len() trước khi gán

len() của một DataFrame là số dòng, len() của list là số phần tử. In cả hai ra là thấy ngay vế nào thiếu. Một giá trị đơn, như chuỗi "Website", thì pandas lặp lại cho mọi dòng nên không cần đủ độ dài:

python
import pandas as pd

don = pd.DataFrame({"ma_don": ["DH1024", "DH1025", "DH1026"]})
phi = [30000, 0]
print(len(don), len(phi))
phi.append(15000)
don["phi_giao"] = phi
don["kenh"] = "Website"
print(don)

KẾT QUẢ

3 2
   ma_don  phi_giao     kenh
0  DH1024     30000  Website
1  DH1025         0  Website
2  DH1026     15000  Website

Đổi phi.append(15000) thành phi.pop() rồi chạy lại: dòng đầu vẫn in 3 2, sau đó chương trình dừng ở lỗi Length of values, vì list chỉ còn một phần tử.

List tính từ bảng đã lọc

Lỗi này hay đến khi bạn tính một list trên một phần của bảng rồi gán vào cả bảng. Bảng lọc có hai dòng, bảng gốc có ba:

List chỉ có vị trí, nên pandas đòi đủ một phần tử cho mỗi dòng. Series còn mang index, nên pandas đặt từng giá trị vào đúng dòng có cùng nhãn, dòng không có nhãn tương ứng nhận NaN:

python
import pandas as pd

don = pd.DataFrame({"ma_don": ["DH1024", "DH1025", "DH1026"],
                    "tong": [250000, 420000, 360000]})
lon = don[don["tong"] > 300000]
don["giam"] = lon["tong"] * 0.1
print(don)

KẾT QUẢ

   ma_don    tong     giam
0  DH1024  250000      NaN
1  DH1025  420000  42000.0
2  DH1026  360000  36000.0

Đơn DH1024 không qua ngưỡng nên không có mức giảm. Cột giam thành số thực vì NaN là một số thực.

Length mismatch khi đổi tên cột

Gán cả list tên cho df.columns cũng cần đúng một tên cho mỗi cột. Thông báo lúc này viết khác, nhưng cùng nghĩa: bảng có 2 cột, list mới có 1 tên.

python
import pandas as pd

don = pd.DataFrame({"ma_don": ["DH1024"], "tong": [250000]})
don.columns = ["ma"]

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

text
ValueError: Length mismatch: Expected axis has 2 elements, new values have 1 elements

Chỉ đổi một vài tên thì dùng rename(columns={"ma_don": "ma"}), không cần kể lại cả list.

Kiểm tra nhanh

  1. Sau import pandas as pd và bang = pd.DataFrame({"a": [1, 2, 3]}), bang["b"] = [1, 2, 3, 4] báo lỗi gì?

    • Báo lỗi ValueError
    • Báo lỗi KeyError
    • Báo lỗi IndexError
  2. Thông báo Length of values (5) does not match length of index (8) cho biết gì?

    • Bảng có 5 dòng, list có 8 phần tử
    • List có 5 phần tử, bảng có 8 dòng
    • Bảng có 5 cột, list có 8 phần tử
  3. Bảng don có 3 dòng, index 0, 1, 2. Những lệnh gán nào chạy mà không báo lỗi?

    • don["kenh"] = "Website"
    • don["phi"] = [30000, 0]
    • don["phi"] = pd.Series([30000, 0], index=[0, 2])
    • don["phi"] = [30000, 0, 15000]
Đúng hết lần đầu +15 XP

Bài tập

Thêm cột từ một list có thể lệch độ dài

List giá trị nhận từ một nguồn khác đôi khi thiếu hay thừa phần tử. Viết thân hàm them_cot_du_dai(bang, ten, gia_tri): trả về bản sao của bang có thêm cột tên ten. Cột mới lấy các phần tử của list gia_tri theo thứ tự từ đầu. List ngắn hơn số dòng thì các dòng cuối nhận None; list dài hơn thì bỏ các phần tử thừa ở cuối.

Hàm không sửa bảng bang của nơi gọi.

Trả về: bảng có thêm cột mới, một DataFrame.

python
import pandas as pd

def them_cot_du_dai(bang, ten, gia_tri):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • Số đầu trong thông báo là độ dài của list bạn gán, số sau là số dòng của bảng.

  • In len(df) và len(list) trước khi gán để biết vế nào thiếu.

  • Một giá trị đơn được lặp cho mọi dòng, không cần đủ độ dài.

  • List khớp theo vị trí, phải đủ phần tử; Series khớp theo index, dòng thiếu nhận NaN.

  • Kết quả tính trên bảng đã lọc thì gán dạng Series, không đổi sang list.

  • Length mismatch: Expected axis has ... là cùng lỗi khi gán df.columns.

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

Lỗi length of values does not match length of index khi dùng apply hay vòng for là sao?

Vòng for thường nối kết quả vào một list, và chỉ cần một nhánh if quên append() là list thiếu phần tử. In len() của list sau vòng lặp để so với số dòng. apply() trên một cột thì trả một giá trị cho mỗi dòng, nên lỗi hiện ra quanh apply thường đến từ một list dựng riêng rồi mới gán. Cách thêm cột không cần vòng lặp có ở bài thêm cột.

Muốn gán một list ngắn chỉ vào vài dòng đầu thì làm sao?

Dựng list đủ độ dài với None ở các dòng còn lại, như bài tập trên. Cách này ghi rõ dòng nào chưa có giá trị thay vì để pandas đoán.

Gán một numpy array thì có khác list không?

Không: array cũng không có index nên pandas đòi đủ độ dài, và thông báo lỗi giống hệt. Chỉ Series mới được khớp theo nhãn.

Vì sao sau khi gán Series, cột số nguyên thành số thực?

Vì có dòng nhận NaN, mà NaN là một giá trị kiểu số thực. Bảng DataFrame giữ một kiểu cho cả cột, nên cả cột đổi sang float64.

Chủ đề

length of values does not match length of index

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