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

Ghi file CSV trong Python (write CSV): csv.writer

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

Bài 7/10 · Chương 10

File và dữ liệu

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

Ghi file CSV trong Python là xuất một bảng dữ liệu ra file văn bản mà Excel và Google Sheets mở được, bằng csv.writer cho các hàng là list và csv.DictWriter cho các hàng là dict. Bạn ghi CSV khi muốn gửi báo cáo chi tiêu tháng cho người khác, hay lưu kết quả tính toán để mở lại bằng bảng tính.

Cần biết trước: đọc file CSV và ghi file.

Ghi từng hàng bằng csv.writer

csv.writer(f) nhận một file đang mở để ghi, và writerow() ghi một list thành một hàng. Mở file với newline="" như khi đọc CSV:

python
import csv

with open("chi_tieu.csv", "w", encoding="utf-8", newline="") as f:
    viet = csv.writer(f)
    viet.writerow(["ngay", "danh_muc", "so_tien", "ghi_chu"])
    viet.writerow(["01/09/2026", "ăn uống", 29000, "cà phê"])
    viet.writerow(["05/09/2026", "ăn uống", 45000, "cơm, canh"])

with open("chi_tieu.csv", encoding="utf-8") as f:
    print(f.read(), end="")

KẾT QUẢ

ngay,danh_muc,so_tien,ghi_chu
01/09/2026,ăn uống,29000,cà phê
05/09/2026,ăn uống,45000,"cơm, canh"

writerow() tự đặt dấu phẩy giữa các ô và tự xuống dòng, khác write() phải tự thêm \n. Số 29000 được đổi thành chữ, không cần str(). Ô cơm, canh có dấu phẩy nên được bọc trong ngoặc kép, để người đọc file vẫn thấy một ô. Đổi "cơm, canh" thành "cơm trưa" rồi chạy lại: dòng cuối in 05/09/2026,ăn uống,45000,cơm trưa, không còn ngoặc kép.

Ghi nhiều hàng một lần bằng writerows()

Khi đã có cả bảng là một list các list, writerows() ghi hết trong một lời gọi:

python
import csv

bang_diem = [
    ["ho_ten", "diem"], ["Lan", 9], ["Minh", "7,5"], ["Ngọc", 10],
]
with open("bang_diem.csv", "w", encoding="utf-8", newline="") as f:
    csv.writer(f).writerows(bang_diem)

with open("bang_diem.csv", encoding="utf-8", newline="") as f:
    print(list(csv.reader(f)))

KẾT QUẢ

[['ho_ten', 'diem'], ['Lan', '9'], ['Minh', '7,5'], ['Ngọc', '10']]

Đọc lại bằng csv.reader cho đúng bảng đã ghi, kể cả ô 7,5. Điểm số đọc về là chuỗi '9', vì CSV chỉ chứa văn bản: một vòng ghi rồi đọc không giữ kiểu int.

Ghi các dict bằng DictWriter

Dữ liệu thường ở dạng list các dict, giống thứ DictReader trả về. csv.DictWriter cần thêm fieldnames, danh sách tên cột theo thứ tự muốn ghi. writeheader() ghi dòng tên cột, writerow(d) ghi một dict, writerows() ghi một list các dict:

python
import csv

giao_dich = [
    {"ngay": "01/09/2026", "danh_muc": "ăn uống", "so_tien": 29000},
    {"ngay": "02/09/2026", "so_tien": 150000},
]
with open("so_chi.csv", "w", encoding="utf-8", newline="") as f:
    cot = ["ngay", "danh_muc", "so_tien"]
    viet = csv.DictWriter(f, fieldnames=cot)
    viet.writeheader()
    viet.writerows(giao_dich)

with open("so_chi.csv", encoding="utf-8") as f:
    print(f.read(), end="")

KẾT QUẢ

ngay,danh_muc,so_tien
01/09/2026,ăn uống,29000
02/09/2026,,150000

Thứ tự cột theo fieldnames, không theo thứ tự khóa trong từng dict. Dict thứ hai thiếu danh_muc nên ô đó để trống: hai dấu phẩy liền nhau. Hãy hình dung fieldnames như dòng kẻ cột in sẵn trên tờ giấy: mỗi giá trị được đặt đúng vào cột có tên của nó.

Ghi để Excel mở đúng

Hai chi tiết quyết định file mở trong Excel có đẹp không. encoding="utf-8-sig" thêm BOM ở đầu file, dấu hiệu để Excel nhận ra UTF-8 và hiện đúng chữ có dấu; thiếu nó, Excel trên Windows có thể hiện chữ lạ. newline="" giữ ký tự xuống dòng \r\n mà csv.writer ghi, không để Windows đổi thêm lần nữa. Trình chạy trên trang không phải Windows, nên ví dụ dưới đây giả lập cách Windows đổi ký tự xuống dòng bằng newline="\r\n":

python
import csv

bang = [["danh_muc", "so_tien"], ["nhà ở", 3500000]]
for kieu in ["", "\r\n"]:
    with open("excel.csv", "w", encoding="utf-8-sig",
              newline=kieu) as f:
        csv.writer(f).writerows(bang)
    with open("excel.csv", encoding="utf-8-sig", newline="") as f:
        print(f.read().split("\n"))

KẾT QUẢ

['danh_muc,so_tien\r', 'nhà ở,3500000\r', '']
['danh_muc,so_tien\r\r', 'nhà ở,3500000\r\r', '']

Dòng đầu là file ghi với newline="": mỗi hàng kết thúc bằng đúng \r\n. Dòng thứ hai là điều xảy ra trên Windows khi thiếu newline="": mỗi hàng kết thúc bằng \r\r\n, và Excel hiểu đó là hai lần xuống dòng.

Kiểm tra nhanh

  1. Với viet = csv.writer(f), lệnh viet.writerow(["Huế", "đường 3/2, quận 10"]) ghi dòng nào vào file?

    • Huế,đường 3/2, quận 10
    • Huế,"đường 3/2, quận 10"
    • "Huế","đường 3/2, quận 10"
  2. Những điều nào đúng khi ghi file CSV cho người dùng Excel trên Windows?

    • newline="" tránh một dòng trống sau mỗi hàng
    • encoding="utf-8-sig" thêm BOM để Excel nhận ra UTF-8
    • writerow() cần \n ở cuối list để xuống dòng
    • Phải đổi mọi số thành chuỗi bằng str() trước khi ghi
  3. Trong ví dụ DictWriter, vì sao hàng của ngày 02/09/2026 có hai dấu phẩy liền nhau?

    • writerows() ghi thêm một ô rỗng sau mỗi ngày
    • Dict đó thiếu khóa danh_muc, nên ô của cột đó để trống
    • Số 150000 được ghi thành hai ô
  4. DictWriter có fieldnames=["ngay", "so_tien"]. Dict nào làm writerow() báo ValueError?

    • {"ngay": "01/09/2026"}
    • {"so_tien": 29000, "ngay": "01/09/2026"}
    • {"ngay": "01/09/2026", "so_tien": 29000, "ghi_chu": "cà phê"}
Đúng hết lần đầu +15 XP

Bài tập

Xuất báo cáo chi tiêu ra file CSV

Sau khi cộng chi tiêu theo danh mục, ứng dụng cần xuất kết quả cho người dùng mở bằng Excel. Viết thân hàm xuat_bao_cao(ten_file, tong), với tong là dict tên danh mục và tổng chi. Mở ten_file để ghi với encoding="utf-8-sig" và newline="", dùng csv.DictWriter có fieldnames=["danh_muc", "so_tien"], ghi dòng tiêu đề bằng writeheader(), rồi mỗi cặp của tong một hàng, theo thứ tự của dict. Hàm không sửa dict tong.

Ví dụ: xuat_bao_cao("bc_a.csv", {"ăn uống": 106000, "đi lại": 150000}) ghi ba dòng (tiêu đề và hai hàng) và trả về 2.

Trả về: số hàng dữ liệu đã ghi, không tính dòng tiêu đề, một int.

python
import csv

def xuat_bao_cao(ten_file, tong):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • csv.writer(f).writerow(list) ghi một hàng, tự thêm dấu phẩy, ngoặc kép khi cần và ký tự xuống dòng.

  • writerows() ghi cả một list các hàng trong một lời gọi.

  • csv.DictWriter(f, fieldnames=[...]) ghi dict theo thứ tự cột; writeheader() ghi dòng tên cột.

  • Dict có khóa ngoài fieldnames làm writerow() báo ValueError; khóa thiếu thành ô trống.

  • File cho Excel mở bằng encoding="utf-8-sig" và newline="" để đúng tiếng Việt, không dòng trống.

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

Vì sao file CSV ghi bằng Python mở trong Excel có dòng trống xen giữa?

File được mở để ghi mà thiếu newline="", và chương trình chạy trên Windows: mỗi hàng kết thúc bằng \r\r\n như ví dụ giả lập của bài. Thêm newline="" vào open() là hết. Khi đọc lại file đó, bạn cũng mở với newline="", như bài đọc file CSV hướng dẫn.

DictWriter trong Python khác csv.writer ở đâu?

csv.writer ghi list theo vị trí: ô đầu của list vào cột đầu. DictWriter ghi dict theo tên cột trong fieldnames, nên thứ tự khóa trong dict không quan trọng và có sẵn writeheader(). Dữ liệu đọc từ DictReader thì ghi lại bằng DictWriter là gọn nhất.

Thêm hàng vào cuối một file CSV đã có thì làm sao?

Mở file bằng chế độ "a" với newline="", tạo csv.writer hay DictWriter rồi writerow() như thường, nhưng đừng gọi writeheader() lần nữa. Chế độ "a" ghi tiếp sau nội dung cũ, như bài ghi file giải thích. Ghi nối vẫn dùng "utf-8-sig": Python chỉ ghi BOM khi file đang rỗng.

Chủ đề

python write csv

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