본문으로 바로 가기
인생은 여울여울

홈 / 글 모아보기

파이썬 CSV 열 지정하기: DictWriter의 추가 키 오류 해결

CSV를 저장할 때 딕셔너리에 열 목록에 없는 키가 있으면 DictWriter는 기본 설정에서 오류를 냅니다. 필요한 키를 fieldnames에 추가해 보세요. 아래 연습은 메모리에서만 실행하므로 기존 파일을 덮어쓰지 않습니다.

오류를 확인한 뒤 열 목록을 고쳐 보세요

가상 메모 두 개로 실행합니다. 첫 번째에는 status가 있고 두 번째에는 없습니다. 먼저 열 목록에서 status를 빠뜨려 오류를 확인한 다음 새 결과에 세 열을 지정합니다.

import csv
from io import StringIO

rows = [
    {"name": "민지", "item": "노트", "status": "완료"},
    {"name": "도윤", "item": "펜"},
]

first = StringIO(newline="")
writer = csv.DictWriter(first, fieldnames=["name", "item"])
writer.writeheader()
try:
    writer.writerow(rows[0])
except ValueError as error:
    print("오류:", error)

result = StringIO(newline="")
writer = csv.DictWriter(result, fieldnames=["name", "item", "status"])
writer.writeheader()
writer.writerows(rows)
print("수정한 CSV:")
print(result.getvalue(), end="")

Python 3.14.4에서 실행한 결과입니다.

오류: dict contains fields not in fieldnames: 'status'
수정한 CSV:
name,item,status
민지,노트,완료
도윤,펜,

오류의 status는 딕셔너리에는 있지만 첫 열 목록에는 없던 키입니다. 수정 후 첫 줄의 name,item,status가 열 순서가 되고 첫 행에는 완료가 들어갑니다. 두 번째 행에는 해당 키가 없어 마지막 칸이 비어 있습니다. 빈 칸이 원래 빈 문자열이었는지 키가 없었는지는 이 출력만으로 구분할 수 없으므로, 구분이 필요하면 쓰기 전에 입력을 확인하세요.

실제 파일에 옮기기 전 확인하세요

Python 공식 문서에 따르면 fieldnames는 출력 순서를 정하고 누락된 키에는 기본적으로 빈 문자열을 씁니다. 추가 키는 기본적으로 오류이며 extrasaction="ignore"를 쓰면 해당 값이 출력에서 빠집니다. 필요한 값인지 확인하기 전에는 무시하지 마세요.

실제 파일에 저장한다면 연습용 새 파일을 사용하고 open(..., "w", encoding="utf-8", newline="")으로 열어 StringIO 대신 writer에 전달하세요. "w"는 같은 이름의 기존 파일을 덮어쓰므로 이름을 먼저 확인해야 합니다. 저장 뒤 열 제목과 각 행을 다시 열어 예상한 값이 있는지 확인하세요. 이미 받은 CSV를 읽을 때 열 이름이 다르다면 CSV 헤더 확인 실습으로 이어갈 수 있습니다.

댓글 남기기