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

pandas to_csv(): ghi CSV mở bằng Excel không lỗi font

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

Bài 3/12 · Chương 3

Đọc và ghi dữ liệu

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

Phương thức to_csv() của pandas ghi một DataFrame ra file CSV, mỗi dòng của bảng thành một dòng của file. Bạn dùng nó khi đã lọc, tính xong một bảng và muốn gửi kết quả cho người khác mở bằng Excel hay Google Sheets, hoặc lưu lại để lần sau đọc tiếp.

Cần biết trước: read_csv() và UTF-8 và encoding.

Ghi DataFrame ra file CSV

Ví dụ đọc ba khoản chi đầu của chi_tieu.csv trong bộ dữ liệu thực hành, ghi chúng ra file mới, rồi mở file đó như văn bản để xem pandas đã ghi gì:

python
import pandas as pd

chi_tieu = pd.read_csv("chi_tieu.csv", nrows=3)
chi_tieu.to_csv("ba_khoan.csv")
with open("ba_khoan.csv", encoding="utf-8") as f:
    print(f.read(), end="")

KẾT QUẢ

,ngay,danh_muc,mo_ta,so_tien,hinh_thuc
0,2025-01-01,Ăn uống,Bánh cuốn,27000,Tiền mặt
1,2025-01-01,Ăn uống,Cơm trưa văn phòng,59000,Tiền mặt
2,2025-01-01,Ăn uống,Cà phê,35000,Ví điện tử

Đối số đầu của to_csv() là tên file; file chưa có thì pandas tạo mới. Dòng đầu là tên cột, các dòng sau là dữ liệu, cách nhau bằng dấu phẩy. Cột đầu tiên, không tên và chứa 0, 1, 2, là index của bảng: mặc định to_csv() ghi cả index thành một cột.

Bỏ cột index bằng index=False

Index 0, 1, 2 chỉ là số thứ tự pandas tự đánh khi đọc file, và không mang thông tin gì về khoản chi. index=False bảo to_csv() đừng ghi nó:

python
import pandas as pd

chi_tieu = pd.read_csv("chi_tieu.csv", nrows=3)
chi_tieu.to_csv("ba_khoan.csv", index=False)
with open("ba_khoan.csv", encoding="utf-8") as f:
    print(f.readline(), end="")
print(pd.read_csv("ba_khoan.csv").shape)

KẾT QUẢ

ngay,danh_muc,mo_ta,so_tien,hinh_thuc
(3, 5)

Dòng tên cột giờ bắt đầu thẳng bằng ngay, và đọc lại cho đúng năm cột như bảng gốc. Đổi index=False thành index=True rồi chạy lại: dòng đầu in ,ngay,danh_muc,mo_ta,so_tien,hinh_thuc và bảng đọc lại có sáu cột.

Gặp file người khác đã ghi kèm index thì sửa lúc đọc: index_col=0 bảo read_csv() dùng cột đầu làm index thay cho một cột dữ liệu.

python
import pandas as pd

chi_tieu = pd.read_csv("chi_tieu.csv", nrows=3)
chi_tieu.to_csv("ba_khoan.csv")
sua = pd.read_csv("ba_khoan.csv", index_col=0)
print(sua.columns.to_list())
print(sua.shape)

KẾT QUẢ

['ngay', 'danh_muc', 'mo_ta', 'so_tien', 'hinh_thuc']
(3, 5)

Ghi cho Excel với encoding="utf-8-sig"

pandas ghi chữ bằng UTF-8, nhưng file CSV không ghi kèm tên bảng mã của nó. Excel trên Windows phải tự đoán, và đoán sai thì "Phở bò" hiện thành một dãy ký tự lạ. Hãy nghĩ tới một thùng hàng gửi đi: ngoài thùng có nhãn thì người nhận biết ngay bên trong là gì. Ba byte BOM ở đầu file là cái nhãn "UTF-8" cho Excel, và encoding="utf-8-sig" dán nhãn đó. Ví dụ ghi một menu ba món:

python
import pandas as pd

menu = pd.DataFrame({"mon": ["Phở bò", "Bún chả", "Cà phê sữa"],
                     "gia": [55000, 45000, 29000]})
menu.to_csv("menu.csv", index=False, encoding="utf-8-sig")
with open("menu.csv", "rb") as f:
    print(f.read(6))
print(pd.read_csv("menu.csv").columns[0])

KẾT QUẢ

b'\xef\xbb\xbfmon'
mon

Dòng đầu đọc sáu byte đầu của file ở dạng byte ("rb"): ba byte \xef\xbb\xbf là BOM, rồi mới tới chữ mon. read_csv() tự bỏ BOM khi đọc, nên tên cột đầu vẫn là mon: cùng một file vừa hợp với Excel vừa đọc lại được bằng pandas. Cách BOM và bảng mã hoạt động có ở bài UTF-8 và encoding.

Lấy nội dung CSV mà không ghi file

Gọi to_csv() không có tên file thì nó không ghi gì ra đĩa mà trả về cả nội dung CSV trong một chuỗi. Cách này hợp khi bạn muốn xem trước file sẽ trông thế nào, hay dán kết quả vào một tin nhắn:

python
import pandas as pd

chi_tieu = pd.read_csv("chi_tieu.csv", nrows=2)
print(chi_tieu.to_csv(index=False), end="")

KẾT QUẢ

ngay,danh_muc,mo_ta,so_tien,hinh_thuc
2025-01-01,Ăn uống,Bánh cuốn,27000,Tiền mặt
2025-01-01,Ăn uống,Cơm trưa văn phòng,59000,Tiền mặt

Chuỗi trả về giống từng ký tự với nội dung file mà lệnh ghi cùng tham số tạo ra, kể cả index=False.

Kiểm tra nhanh

  1. Trong ví dụ đầu bài, bảng ba khoản chi được ghi bằng to_csv("ba_khoan.csv") không có tham số nào khác. Dòng đầu của file mở bằng ký tự nào?

    • Dấu phẩy
    • Chữ n của ngay
    • Số 0
  2. Sau khi ghi bằng index=False, đọc lại file bằng read_csv() thì bảng có mấy cột so với bảng gốc?

    • Nhiều hơn một cột
    • Bằng số cột của bảng gốc
    • Ít hơn một cột
  3. Những câu nào đúng về cột Unnamed: 0?

    • Nó xuất hiện khi đọc lại file được ghi mà không có index=False
    • Đọc với index_col=0 thì nó thành index thay cho một cột dữ liệu
    • Nó là lỗi bảng mã, sửa bằng encoding="utf-8-sig"
    • read_csv() báo lỗi khi gặp nó
  4. Chị kế toán mở file CSV bạn gửi bằng Excel và thấy chữ "Ăn uống" bị lỗi. Bạn sửa lệnh ghi thế nào?

    • Thêm index=False
    • Thêm encoding="utf-8-sig"
    • Thêm encoding="ascii"
Đúng hết lần đầu +15 XP

Bài tập

Đọc file có thể thừa cột index

Bạn nhận file CSV từ nhiều người: có người ghi bằng to_csv() mà quên index=False, nên file có thêm cột index ở đầu, có người ghi đúng. Viết thân hàm doc_sach(duong_dan): đọc file ở duong_dan; nếu cột đầu của bảng đọc được tên Unnamed: 0 thì bỏ cột đó, ngược lại giữ mọi cột. Bảng trả về có index mặc định 0, 1, 2…, các cột dữ liệu giữ nguyên tên và thứ tự.

Trả về: bảng đã đọc, một DataFrame.

python
import pandas as pd

def doc_sach(duong_dan):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • df.to_csv("ten.csv") ghi bảng ra file CSV; file cùng tên bị ghi đè không hỏi lại.

  • Mặc định to_csv() ghi cả index thành cột đầu không tên.

  • Đọc lại file đó cho cột Unnamed: 0; ghi với index=False để tránh, hoặc đọc với index_col=0.

  • encoding="utf-8-sig" thêm BOM để Excel mở đúng chữ có dấu; read_csv() vẫn đọc lại bình thường.

  • to_csv() không có tên file trả về nội dung CSV trong một chuỗi.

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

Làm sao save DataFrame to CSV mà không bị thừa cột index?

Ghi với df.to_csv("ten.csv", index=False). Chỉ giữ index khi nó mang dữ liệu thật, như tên món hay ngày sau khi đặt index; khi đó đặt tên cho index trước, theo bài set_index(), để cột đầu của file có tên.

Xuất DataFrame ra CSV mà Excel vẫn gộp mọi thứ vào một cột thì sao?

Excel đặt ngôn ngữ Việt Nam hay dùng dấu chấm phẩy làm dấu phân cách, nên đọc file dấu phẩy thành một cột. Ghi thêm sep=";" cho người dùng Excel đó; tham số sep của to_csv() giống của read_csv() trong bài read_csv nâng cao.

Ghi file CSV bằng pandas có giữ số 0 đầu của mã không?

Có, nếu cột mã là chuỗi: to_csv() ghi đúng chữ 0001. Mất số 0 xảy ra lúc đọc vào, khi thiếu dtype như bài read_csv() cho thấy, hay khi Excel mở file và tự đổi ô thành số.

Muốn ghi ra file Excel .xlsx thay cho CSV thì dùng gì?

Dùng to_excel(), cần thêm gói openpyxl. Bài to_excel() dạy cách ghi một hay nhiều sheet; bài Blog đọc CSV và Excel bằng pandas so hai định dạng.

Chủ đề

pandas to csv

Dữ liệu của bài

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