Ghi file CSV trong Python (write CSV): csv.writer
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
Trong bài này · 11
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:
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:
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:
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,,150000Thứ 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":
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
Với
viet = csv.writer(f), lệnhviet.writerow(["Huế", "đường 3/2, quận 10"])ghi dòng nào vào file?Huế,đường 3/2, quận 10Huế,"đường 3/2, quận 10""Huế","đường 3/2, quận 10"
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àngencoding="utf-8-sig"thêm BOM để Excel nhận ra UTF-8writerow()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
Trong ví dụ
DictWriter, vì sao hàng của ngày02/09/2026có 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 ô
DictWritercófieldnames=["ngay", "so_tien"]. Dict nào làmwriterow()báoValueError?{"ngay": "01/09/2026"}{"so_tien": 29000, "ngay": "01/09/2026"}{"ngay": "01/09/2026", "so_tien": 29000, "ghi_chu": "cà phê"}
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.
import csv
def xuat_bao_cao(ten_file, tong):
pass # Viết thân hàm thay cho dòng nàyTó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
fieldnameslàmwriterow()báoValueError; 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ủ đề
Bài này có hữu ích?
Hỏi đáp
Tham vấn chuyên môn
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.