CSV 엑셀 한글 깨짐 해결, UTF-8 BOM·CP949·따옴표 규칙 정리

서버에서 내려받은 CSV를 엑셀로 열었더니 홍길동이 �솉湲몃룞 같은 외계어로 바뀌어 있던 경험, 개발자라면 한 번쯤 있을 거예요. 결론부터 말하면 한국어 윈도우 엑셀은 BOM이 없는 CSV를 CP949(EUC-KR 확장)로 읽기 때문에 UTF-8 파일이 깨지고, 파일 맨 앞에 UTF-8 BOM 3바이트(EF BB BF)를 붙여 저장하면 엑셀이 UTF-8로 알아보고 한글이 제대로 나와요. 메모장이나 VS Code에서는 멀쩡한데 엑셀에서만 깨지는 이유가 바로 이거예요.

그런데 한글 깨짐만 고치면 끝이 아니더라고요. 주소에 쉼표가 들어가면 칸이 밀리고, 전화번호 010의 0이 사라지고, 16자리 카드번호 끝자리가 0으로 바뀌고, JSON을 CSV로 바꾸면 [object Object]가 찍혀요. 이 글에서는 실제 바이트와 실행 결과로 원인을 하나씩 짚고, CSV를 "엑셀에서도 안 깨지게" 만드는 체크리스트까지 정리했어요.

핵심 요약

엑셀 한글 깨짐은 인코딩 불일치예요. UTF-8로 저장하되 맨 앞에 BOM(EF BB BF)을 붙이거나, 엑셀의 "텍스트/CSV에서 가져오기"로 인코딩을 65001(UTF-8)로 지정하세요.

RFC 4180 규칙상 쉼표·큰따옴표·줄바꿈이 들어간 값은 전체를 큰따옴표로 감싸고, 값 안의 큰따옴표는 두 번("")으로 씁니다.

앞자리 0, 12자리 이상 숫자의 지수 표기, 15자리 넘는 숫자의 끝자리 손실은 CSV가 아니라 엑셀의 자동 형식 변환 탓이라 가져오기 단계에서 열 형식을 "텍스트"로 지정해야 막을 수 있어요.

JSON을 CSV로 바꿀 땐 중첩 객체는 address.city처럼 점 경로 열로 펼치고, 배열은 JSON 문자열로 넣는 게 정보 손실이 가장 적어요.

CSV 엑셀 한글 깨짐, 왜 생길까

CSV 파일에는 "나는 어떤 인코딩이다"라는 정보가 없어요. 그냥 바이트의 나열이라, 여는 프로그램이 인코딩을 추측해야 합니다. 그리고 한국어 윈도우의 엑셀은 별다른 표시가 없으면 시스템 기본 코드 페이지인 CP949로 읽어요.

문제는 요즘 서버·파이썬·자바스크립트가 만드는 CSV가 거의 전부 UTF-8이라는 점이에요. "홍길동"을 바이트로 보면 차이가 분명합니다(파이썬으로 직접 확인한 값).

UTF-8 바이트 9개를 CP949 규칙(대부분 2바이트가 한 글자)으로 읽으면, 첫 바이트 ED는 짝이 맞지 않아 �가 되고 이어서 99 8D → 솉, EA B8 → 湲, B8 EB → 몃, 8F 99 → 룞처럼 엉뚱하게 짝이 지어져 �솉湲몃룞이 됩니다. 헤더 이름,전화번호도 같은 방식으로 �씠由�,�쟾�솕踰덊샇가 돼요. 반대로 CP949로 저장한 파일을 UTF-8로 열면 ȫ�浿처럼 깨지고요. 깨진 모양이 한자·특수문자 섞인 한글이면 UTF-8을 CP949로 읽은 것, 물음표와 라틴 문자가 섞이면 CP949를 UTF-8로 읽은 것이라고 기억해 두면 디버깅이 빨라져요. 한글 바이트 구조는 한글 한 글자 몇 바이트? UTF-8과 EUC-KR 차이에 자세히 정리했어요.

해결 1: UTF-8 BOM 붙여서 저장하기

BOM(Byte Order Mark)은 파일 맨 앞에 붙이는 U+FEFF 문자예요. UTF-8로 쓰면 EF BB BF 3바이트이고, 엑셀은 이 3바이트를 보면 "UTF-8 파일이구나" 하고 제대로 읽어요. 내용은 그대로 두고 앞에 3바이트만 붙이는 거라 용량 부담도 사실상 없습니다.

언어별로 BOM을 붙이는 방법은 이렇습니다.

# 파이썬: encoding을 utf-8-sig로 주면 BOM이 붙어요
import csv
with open('users.csv', 'w', encoding='utf-8-sig', newline='') as f:
    csv.writer(f).writerows(rows)
# pandas
df.to_csv('users.csv', index=False, encoding='utf-8-sig')

// 브라우저에서 다운로드: 문자열 앞에 \uFEFF를 붙여요
const blob = new Blob(['\uFEFF' + csvText], { type: 'text/csv;charset=utf-8' });
// Node.js
fs.writeFileSync('users.csv', '\uFEFF' + csvText, 'utf8');

자바는 OutputStreamWriter로 UTF-8 스트림을 연 뒤 첫 글자로 '\uFEFF'를 쓰면 되고, 스프링에서 응답으로 내려줄 때도 본문 맨 앞에 같은 문자를 붙이면 돼요. 파이썬에서 newline=''를 꼭 주는 이유는, 안 주면 윈도우에서 줄바꿈이 \r\r\n으로 두 번 들어가 빈 줄이 생기기 때문이에요.

BOM의 부작용도 알아 두기

BOM은 엑셀에겐 고마운 표시지만, 다른 프로그램에겐 그냥 "보이지 않는 문자 하나"예요. 그래서 이런 일이 생깁니다.

• 파이썬에서 encoding='utf-8'로 읽으면 첫 열 이름이 '\ufeff이름'이 돼서 row['이름']이 KeyError가 나요. 읽을 때도 utf-8-sig를 쓰면 BOM이 있든 없든 알아서 처리됩니다.
• 리눅스 cut, awk나 일부 DB의 CSV 적재 기능은 첫 컬럼명에 BOM이 섞여 들어가요.
• JSON 파일에 BOM이 붙으면 JSON.parse가 Unexpected token으로 실패하기도 해요. JSON 표준은 BOM을 붙이지 말라고 하고 있어요.

그래서 실무에서는 "사람이 엑셀로 열 파일"에만 BOM을 붙이고, 시스템끼리 주고받는 CSV는 BOM 없는 UTF-8로 맞추는 걸 추천해요.

해결 2: BOM 없이 엑셀에서 제대로 여는 법

받은 파일을 고칠 수 없을 때는 엑셀에서 여는 방법을 바꾸면 돼요. 파일을 더블클릭하지 말고 데이터 → 텍스트/CSV에서 메뉴로 가져오면, 미리보기 창 위쪽 "파일 원본"에서 65001: 유니코드(UTF-8)를 고를 수 있어요. 이 화면에서 열 형식을 미리 지정할 수 있어서 뒤에 나올 앞자리 0 문제도 같이 해결됩니다.

다른 방법들도 정리해 볼게요.

CP949로 저장하는 건 최후의 수단이에요. CP949는 이모지를 아예 담을 수 없고, 이름에 들어가는 일부 옛 한글이나 특수 기호도 빠지거나 ?로 바뀌어요. 파이썬에서 encode('cp949')를 하면 UnicodeEncodeError가 나는 순간이 그때입니다.

RFC 4180 CSV 따옴표 규칙, 쉼표와 줄바꿈이 들어간 값

인코딩 다음으로 많이 깨지는 게 "칸 밀림"이에요. CSV는 이름 그대로 쉼표로 칸을 나누는데, 값 안에 쉼표가 있으면 어디까지가 한 칸인지 알 수 없잖아요. 이걸 정한 게 RFC 4180이고, 핵심 규칙은 네 가지예요.

1. 줄 끝은 CRLF(\r\n)를 쓴다. (대부분의 파서는 LF만 있어도 읽어요.)
2. 값에 쉼표, 큰따옴표, 줄바꿈이 있으면 값 전체를 큰따옴표로 감싼다.
3. 감싼 값 안의 큰따옴표는 두 번 써서 이스케이프한다. (" → "") 백슬래시 \"는 표준이 아니에요.
4. 첫 줄은 헤더일 수 있고, 모든 행의 칸 수는 같아야 한다.

예를 들어 메모가 배송 전 연락, "부재 시" 문 앞인 행을 파이썬 csv 모듈로 쓰면 이렇게 나와요.

이름,메모,전화번호,우편번호
홍길동,"배송 전 연락, ""부재 시"" 문 앞",01012345678,04524

쉼표가 있으니 전체를 감쌌고, 안의 큰따옴표는 ""로 두 번 들어갔어요. 줄바꿈이 들어간 주소도 마찬가지로 따옴표 안이면 한 칸으로 읽혀요.

직접 split(',') 하면 안 되는 이유

CSV를 읽을 때 line.split(',')로 자르는 코드가 정말 많은데, 위 행 하나만 넣어도 칸이 5개로 늘어나요. 따옴표 안의 줄바꿈까지 생각하면 readline()으로 한 줄씩 읽는 것도 틀린 방법이고요. CSV는 반드시 파서로 읽고 쓰세요. 파이썬 csv, 자바스크립트 Papa Parse, 자바 OpenCSV·Apache Commons CSV 같은 라이브러리가 이 규칙을 다 처리해 줍니다.

자주 보는 깨짐 패턴을 정리하면 이래요.

마지막 줄은 유럽 지역 설정의 엑셀이 쉼표 대신 세미콜론(;)을 구분자로 쓰기 때문에 생겨요.

엑셀 앞자리 0 사라짐과 지수 표기 문제

인코딩도 맞고 따옴표도 맞는데 데이터가 바뀌는 경우가 남아 있어요. 이건 CSV 파일 문제가 아니라 엑셀이 열면서 "숫자처럼 보이는 값"을 숫자로 바꾸기 때문이에요. 파일을 메모장으로 열어 보면 01012345678이 멀쩡히 있는데, 엑셀에서는 1012345678로 보이는 거죠. 그리고 그 상태로 저장하면 그때부터는 파일에서도 0이 사라집니다.

엑셀이 바꾸는 규칙은 크게 세 가지예요.

• 앞자리 0 제거: 010, 04524, 007 같은 값은 숫자로 바뀌면서 0이 사라져요. 전화번호, 우편번호, 사번, 상품코드가 대표 피해자예요.
• 지수 표기: "일반" 서식에서 12자리 이상 숫자는 8.80123E+12처럼 지수로 보여요. 값 자체는 남아 있어서 서식을 "숫자"로 바꾸면 돌아오지만, CSV로 다시 저장하면 지수 문자열 그대로 저장될 수 있어요.
• 15자리 넘는 숫자의 끝자리 손실: 엑셀은 숫자를 유효숫자 15자리까지만 보관해요. 16자리 카드번호 1234567812345678은 1234567812345670이 되고, 이건 서식을 바꿔도 돌아오지 않아요. 주문번호·트랜잭션 ID처럼 긴 숫자 ID는 원본이 영구히 망가집니다.

그 밖에 1-2, 3/4 같은 값이 날짜로 바뀌는 것도 같은 원리예요. 최신 Microsoft 365 엑셀에는 "파일 → 옵션 → 데이터 → 자동 데이터 변환"에서 앞자리 0 제거, 긴 숫자 지수 변환 등을 끌 수 있는 설정이 생겼지만, 받는 사람 PC 설정에 기대는 방법이라 파일 쪽에서 막는 게 더 확실해요.

앞자리 0을 지키는 방법

1. 받는 쪽: 데이터 → 텍스트/CSV에서 가져오기 → "데이터 변환"에서 해당 열 형식을 "텍스트"로 지정. 가장 정석이에요.
2. 만드는 쪽, 엑셀 전용 파일: 값을 ="01012345678" 형태로 쓰면 엑셀이 수식 결과를 문자열로 보여 줘요. 단 다른 프로그램에서는 이 값이 그대로 ="..." 문자열로 읽히니 엑셀 전용일 때만 쓰세요.
3. 아예 xlsx로 내보내기: 셀 형식을 텍스트로 지정해서 저장할 수 있어 가장 깔끔해요.
4. ID를 숫자로 다루지 않기: 전화번호, 우편번호, 카드번호는 계산할 일이 없는 "문자열 ID"예요. DB와 JSON에서도 숫자 타입 대신 문자열로 두는 게 맞아요. 자바스크립트 숫자는 2^53 - 1(9007199254740991, 16자리)을 넘으면 정밀도가 깨지니, 긴 ID는 JSON에서도 문자열이어야 합니다.

CSV 인젝션도 함께 막기

값이 =, +, -, @로 시작하면 엑셀이 수식으로 해석할 수 있어요. 사용자가 입력한 이름에 =HYPERLINK(...) 같은 걸 넣어 두면, 관리자가 내려받은 CSV를 열 때 실행되는 "CSV 인젝션"이 됩니다. 사용자 입력을 CSV로 내보낼 땐 이 문자로 시작하는 값 앞에 작은따옴표(')를 붙여 문자열로 취급되게 하는 방어가 흔히 쓰여요.

JSON ↔ CSV 변환: 중첩 객체 평탄화

API 응답 JSON을 엑셀로 넘겨 달라는 요청은 정말 흔하죠. 그런데 JSON은 나무 구조이고 CSV는 표라서, 그대로는 안 들어가요. 아무 처리 없이 문자열로 바꾸면 중첩 객체 칸에 [object Object]가 찍히는 게 그래서예요.

[
  {"id": 1, "name": "홍길동", "address": {"city": "서울", "zip": "04524"}, "tags": ["vip", "new"]},
  {"id": 2, "name": "김철수", "address": {"city": "부산"}, "tags": []}
]

이걸 표로 만드는 일반적인 방법이 평탄화(flatten)예요. 중첩 객체의 키를 점으로 이어 address.city, address.zip 같은 열 이름을 만들고, 배열은 JSON 문자열로 한 칸에 넣습니다. 파이썬으로 변환한 실제 결과예요.

id,name,address.city,address.zip,tags
1,홍길동,서울,04524,"[""vip"", ""new""]"
2,김철수,부산,,[]

여기서 눈여겨볼 점이 세 가지 있어요.

• 열 목록은 모든 행의 키를 합쳐서 만들어야 해요. 첫 행 키만 쓰면 두 번째 행 이후에만 있는 필드가 사라집니다. 김철수에게 없는 address.zip은 빈칸이 됐죠.
• 배열 처리 방식은 선택이에요. JSON 문자열(["vip","new"])로 넣으면 다시 JSON으로 되돌릴 수 있고, tags.0, tags.1처럼 인덱스 열로 펼치면 엑셀에서 보기 좋지만 배열 길이가 들쭉날쭉하면 열이 끝없이 늘어나요. vip;new처럼 구분자로 합치면 읽기는 편하지만 값 안에 구분자가 있으면 되돌릴 수 없어요.
• 타입 정보가 사라져요. CSV에는 숫자·문자열·불리언·null 구분이 없어서, "04524"(문자열)와 4524(숫자), null과 빈 문자열이 모두 같아 보여요. CSV를 다시 JSON으로 바꿀 땐 열마다 타입 규칙을 정해 두는 게 안전합니다.

반대로 CSV → JSON은 헤더를 키로 쓰고 행마다 객체를 만들면 되는데, address.city 같은 점 경로 헤더를 다시 중첩 객체로 복원할지 정해야 해요. 복원하면 원래 구조로 돌아오고, 안 하면 "address.city": "서울"이라는 평평한 키가 됩니다. JSON 문법 자체가 자꾸 깨진다면 JSON 문법 오류 패턴을, 데이터 형식 선택이 고민이면 JSON·YAML·XML 비교를 참고하세요.

엑셀용 CSV 내보내기 체크리스트

지금까지 내용을 "다운로드 버튼 만들 때 확인할 것"으로 묶어 볼게요.

• [ ] 인코딩은 UTF-8, 엑셀용이면 맨 앞에 BOM(\uFEFF)
• [ ] 직접 문자열을 잇지 말고 CSV 라이브러리로 쓰기 (쉼표·따옴표·줄바꿈 자동 처리)
• [ ] 줄바꿈은 \r\n, 파이썬은 newline=''
• [ ] 전화번호·우편번호·긴 ID는 문자열로 다루고, 엑셀 사용자에게는 xlsx나 텍스트 가져오기 안내
• [ ] = + - @로 시작하는 사용자 입력은 CSV 인젝션 방어
• [ ] JSON에서 변환할 땐 모든 행의 키를 합쳐 열 목록 만들기, 배열 처리 방식 정하기
• [ ] 응답 헤더 Content-Type: text/csv; charset=utf-8, 파일명 한글이면 filename*=UTF-8''... 사용

마지막 항목의 파일명은 퍼센트 인코딩 규칙을 따라요. 원리는 URL 인코딩 원리와 한글 URL에서 다뤘어요.

자주 묻는 질문

CSV를 메모장에서 열면 멀쩡한데 엑셀에서만 깨지는 이유는?

메모장과 VS Code는 내용을 보고 UTF-8을 잘 추측하지만, 한국어 윈도우 엑셀은 BOM이 없으면 CP949로 읽기 때문이에요. 메모장에서 "다른 이름으로 저장 → 인코딩: UTF-8(BOM)"으로 다시 저장하면 엑셀에서도 제대로 보여요.

맥 엑셀에서도 BOM이 필요한가요?

네, 맥용 엑셀도 BOM이 없는 UTF-8 CSV를 다른 인코딩으로 읽어 한글이 깨지는 경우가 많아요. BOM을 붙인 파일은 윈도우와 맥 양쪽에서 제대로 열리니 엑셀용 파일에는 붙여 두는 게 안전합니다.

CSV 값 안에 큰따옴표가 있으면 어떻게 쓰나요?

값 전체를 큰따옴표로 감싸고, 안에 있는 큰따옴표는 두 번 써요. 그는 "안녕"이라고 했다는 "그는 ""안녕""이라고 했다"가 됩니다. 백슬래시로 이스케이프하는 건 RFC 4180 표준이 아니라 엑셀에서 깨져요.

엑셀에서 전화번호 앞 0이 사라지는 걸 막으려면?

더블클릭으로 열지 말고 데이터 → 텍스트/CSV에서 가져온 뒤 그 열을 "텍스트" 형식으로 지정하세요. 이미 열어서 0이 사라진 상태로 저장했다면 파일에서도 0이 지워진 것이니, 원본 파일에서 다시 가져와야 해요.

JSON을 CSV로 바꾸면 [object Object]가 나와요.

중첩 객체를 문자열로 그냥 바꿔서 생기는 현상이에요. address.city처럼 점 경로로 평탄화하거나, 객체를 JSON.stringify한 문자열로 넣어야 합니다. JSON ↔ CSV 변환기를 쓰면 평탄화와 따옴표 처리를 한 번에 해 줘요.

정리

CSV가 엑셀에서 깨지는 문제는 세 층으로 나눠 보면 쉬워요. 인코딩(UTF-8 + BOM 또는 가져오기에서 65001), 구조(RFC 4180 따옴표 규칙을 라이브러리로 지키기), 엑셀의 자동 변환(앞자리 0, 지수 표기, 15자리 정밀도 — 텍스트 형식 지정이나 xlsx). 여기에 JSON에서 넘어오는 데이터라면 평탄화 규칙을 하나 정해 두면 끝이에요.

API 응답을 바로 표로 바꿔 보려면 JSON ↔ CSV 변환기를, 변환 전에 JSON 구조를 확인하거나 문법 오류를 찾으려면 JSON 포매터를 써 보세요.