파이썬 파일입출력 UTF-8-SIG 인코딩으로 엑셀 호환 저장하는 방법

🔎 파이썬 파일입출력 기본 이해

파이썬에서 파일을 다루는 기본 동작은 크게 열기(open), 읽기(read), 쓰기(write), 닫기(close) 네 가지 단계로 나눌 수 있습니다.
텍스트 파일, CSV, 로그 파일 등 다양한 데이터를 저장하거나 불러올 때 이 흐름은 항상 동일합니다.

가장 흔히 사용되는 방법은 open() 함수를 활용하는 것으로, 첫 번째 인자로 파일 경로, 두 번째 인자로 모드(mode)를 지정합니다.
모드는 읽기(‘r’), 쓰기(‘w’), 이어쓰기(‘a’) 등으로 나눌 수 있으며, 텍스트 모드와 바이너리 모드도 구분할 수 있습니다.

# 기본적인 파일 쓰기 예제
with open("example.txt", "w", encoding="utf-8") as f:
    f.write("안녕하세요, 파이썬 파일 입출력 예제입니다.")

위 예제는 가장 기본적인 파일 쓰기 코드로, with open() 구문을 사용하여 파일을 열고, 자동으로 닫히도록 처리합니다.
이때 encoding=”utf-8″ 옵션을 지정하면 한글이 깨지지 않게 저장할 수 있습니다.
하지만 여기서 저장된 파일을 엑셀로 열면 간혹 한글이 깨지는 현상이 발생할 수 있는데, 이는 엑셀이 기본적으로 BOM이 포함된 UTF-8-SIG 방식을 선호하기 때문입니다.

📂 텍스트 파일 저장 시 자주 발생하는 문제

파이썬으로 파일을 저장할 때 가장 흔하게 겪는 문제 중 하나는 한글 깨짐 현상입니다.
특히 CSV 파일을 만들어 마이크로소프트 엑셀에서 열 때 이런 문제가 자주 발생합니다.
엑셀은 기본적으로 UTF-8을 완벽히 지원하지 않고, BOM이 없는 UTF-8 파일을 열면 ANSI나 EUC-KR로 잘못 인식해 글자가 깨져 보이는 경우가 있습니다.

예를 들어, 파이썬에서 단순히 encoding="utf-8"로 저장한 CSV 파일을 엑셀에서 열면 데이터가 정상적으로 표시되지 않고 물음표(?)나 깨진 기호로 출력되기도 합니다.
이는 데이터 자체가 손상된 것이 아니라, 프로그램이 파일을 해석하는 방식이 달라 발생하는 문제입니다.

이 외에도, 텍스트 파일 저장 시 흔히 발생하는 문제는 줄바꿈(\n) 처리 방식의 차이입니다.
윈도우에서는 CRLF(\r\n), 리눅스와 맥에서는 LF(\n)을 주로 사용합니다.
다행히 파이썬의 open() 함수는 이러한 차이를 자동으로 처리해 주지만, 직접 파일을 다른 시스템에서 열 때 줄바꿈이 맞지 않는 경우도 있습니다.

💬 즉, 인코딩과 줄바꿈은 파일 입출력에서 반드시 신경 써야 할 핵심 요소이며, 특히 데이터 분석가나 개발자가 CSV 파일을 다룰 때 자주 부딪히는 문제입니다.

💡 UTF-8과 UTF-8-SIG 차이점

UTF-8은 가장 널리 쓰이는 텍스트 인코딩 방식으로, 다국어를 동시에 표현할 수 있다는 장점이 있습니다.
하지만 기본적인 UTF-8 파일에는 BOM(Byte Order Mark)이라는 식별자가 포함되어 있지 않습니다.
이 때문에 윈도우의 일부 프로그램, 특히 엑셀은 UTF-8 파일을 열 때 제대로 해석하지 못하고 글자가 깨질 수 있습니다.

반면, UTF-8-SIG는 파일 맨 앞에 BOM을 추가한 방식입니다.
BOM은 단순히 파일이 UTF-8로 저장되었다는 사실을 알려주는 역할을 하며, 엑셀은 이 BOM이 포함된 파일을 정상적으로 인식해 한글 깨짐 없이 불러옵니다.
즉, 파이썬에서 encoding=”utf-8-sig”를 지정하면 엑셀 호환성을 보장할 수 있습니다.

실제로 CSV 파일을 엑셀에서 바로 열어야 한다면 UTF-8-SIG를 쓰는 것이 가장 안전합니다.
다만, BOM을 필요로 하지 않는 리눅스 환경이나 다른 시스템에서는 BOM 때문에 예상치 못한 문제가 생길 수도 있으므로 상황에 맞게 선택하는 것이 중요합니다.

📝 encoding=”utf-8-sig” 실전 코드 예제

엑셀에서 정상적으로 열 수 있는 CSV 파일을 저장하기 위해서는 파일 저장 시 encoding=”utf-8-sig” 옵션을 반드시 지정해야 합니다.
이를 통해 엑셀은 BOM이 포함된 UTF-8 파일을 인식하고 한글 데이터를 깨짐 없이 보여줍니다.

import csv

data = [
    ["이름", "나이", "직업"],
    ["홍길동", 30, "개발자"],
    ["김철수", 28, "데이터 분석가"]
]

# UTF-8-SIG로 CSV 저장
with open("people.csv", "w", newline="", encoding="utf-8-sig") as f:
    writer = csv.writer(f)
    writer.writerows(data)

위 코드를 실행하면 people.csv 파일이 생성되며, 이를 엑셀에서 열었을 때 한글이 깨지지 않고 정상적으로 표시됩니다.
만약 단순히 utf-8을 사용했다면 같은 파일이라도 엑셀에서는 글자가 깨졌을 가능성이 큽니다.

• 🛠️csv.writer()를 사용해 데이터를 행 단위로 저장
• ⚙️파일 저장 시 반드시 newline=”” 옵션을 추가해 줄바꿈 문제 방지
• 🔌엑셀 호환성을 위해 encoding=”utf-8-sig” 옵션을 지정

이와 같이 단 몇 줄의 코드 수정만으로도 한글 깨짐 문제를 완벽히 해결할 수 있습니다.
특히 업무 현장에서 CSV 파일을 통해 데이터를 주고받는 경우, 이 설정은 반드시 기억해야 할 필수 팁입니다.

⚠️ 주의사항과 활용 팁

UTF-8-SIG는 엑셀과의 호환성을 보장하는 데 매우 유용하지만, 모든 경우에 무조건 적합한 것은 아닙니다.
예를 들어, 리눅스 기반 시스템이나 일부 서버 환경에서는 BOM(Byte Order Mark)이 예상치 못한 문제를 일으킬 수 있습니다.
따라서 어떤 환경에서 파일을 열고 활용할 것인지 먼저 고려해야 합니다.

🔍 BOM이 불필요한 경우

데이터가 웹 애플리케이션, 서버 로그, 리눅스 환경에서 사용되는 경우에는 UTF-8로 저장하는 것이 더 안전합니다.
이 경우 BOM이 오히려 예상치 못한 인식 문제를 발생시킬 수 있기 때문입니다.

💡 업무 활용 팁

만약 데이터 공유 대상이 엑셀 사용자라면 UTF-8-SIG로 저장하는 것이 최적의 선택입니다.
반면에, 데이터가 다른 개발자나 시스템 간에 주고받아야 한다면 BOM이 없는 UTF-8을 선택하는 것이 일반적입니다.

또한, CSV 파일을 직접 엑셀에서 불러올 때는 단순 더블클릭이 아닌, 데이터 → 텍스트/CSV 가져오기 메뉴를 통해 인코딩 방식을 지정하면 문제를 예방할 수 있습니다.
이 방법을 사용하면 BOM 유무에 관계없이 원하는 인코딩을 선택할 수 있어 유연하게 대응할 수 있습니다.

❓ 자주 묻는 질문 (FAQ)