CSV 체커를 만든 이유

CSV 체커는 반복되는 불편함에서 시작된 개인 프로젝트입니다. 파일을 업로드한 뒤에야 나타나는 가져오기 오류 — 원인은 거의 항상 같습니다. 인코딩 불일치, 지난달에는 없던 중복 키, 복사·붙여넣기 과정에서 끼어든 보이지 않는 문자. 이런 문제들은 너무 늦게 드러납니다.

업로드 이전에 문제를 잡아주는 도구를 만드는 것이 목표였습니다. 빠르고, 민감한 업무 데이터를 외부 서버로 전송하지 않으며, 체험만을 위해 로그인할 필요도 없는 도구. 그래서 모든 처리는 브라우저의 JavaScript File API와 TextDecoder로 이루어집니다. CSV 파일은 기기 밖으로 나가지 않습니다.

CSV 체커란

CSV 체커는 CSV 파일을 정기적으로 다루는 모든 분을 위한 브라우저 기반 유틸리티 모음입니다. 데이터 분석가, 시스템 담당자, 운영팀, 개발자, 그리고 한 시스템에서 데이터를 내보내 다른 시스템에 가져오는 업무를 하는 모든 분께 유용합니다.

단일 검사

하나의 CSV의 형식·인코딩·헤더·구분자·빈 행·열 수 불일치 등을 확인합니다.

2개 파일 비교

두 개의 CSV를 비교해 추가·삭제·변경된 행을 색으로 구분해 표시합니다.

글자 깨짐 복구

글자가 깨진 CSV나 텍스트 파일을 브라우저 안에서만 UTF-8(BOM 포함)로 바꿔 주는 도구입니다. 파일을 서버에 올리지 않으며, 모든 처리는 사용 중인 기기에서만 이루어집니다.

주요 기능

드래그 앤 드롭：파일을 영역에 놓기만 하면 변환이 시작됩니다.
인코딩 자동 감지：Shift-JIS, EUC-KR, CP949 등을 자동으로 판별해 올바른 글자로 다시 읽습니다.
수동 인코딩 선택：자동 감지가 맞지 않으면 드롭다운에서 원본 인코딩을 선택할 수 있습니다.
미리보기：변환 결과 상위 10줄을 보여 주어, 글자가 제대로 복구되었는지 확인할 수 있습니다.
UTF-8 BOM 다운로드：엑셀에서 그대로 열 수 있는 형식으로 저장됩니다. 파일 이름은 fixed_원본파일명 형태입니다.

CSV뿐 아니라 TXT, LOG 등 텍스트 기반 파일도 지원합니다. 업무 데이터를 안전하게 복구하고 싶을 때 이용하실 수 있습니다.

이런 분께 유용합니다

신뢰할 수 있는 CSV 파일이 필요한 상황이라면 어디서든 유용합니다:

데이터베이스·SaaS 시스템 업로드 전 — 가져오기 오류나 데이터 손상을 일으키기 전에 인코딩 불일치, 기본 키 중복, 잘못된 행을 미리 잡습니다.
월간 데이터 대사(reconciliation) — 지난달 내보내기와 이번 달 내보내기를 스프레드시트에서 눈으로 비교하지 않고 무엇이 바뀌었는지 빠르게 확인합니다.
가져오기 실패 원인 추적 — "문제없어 보이는데" 계속 실패하는 가져오기를 형식 검사와 단일 검사로 무엇이 잘못됐는지 체크리스트로 정확히 파악합니다.
외부 출처 파일 처리 — 공급업체 내보내기, 공공 데이터, CRM 내보내기는 시스템마다 인코딩·구분자·인용 방식이 다릅니다. CSV 체커로 정규화합니다.
민감 데이터가 포함된 파일 작업 — 업로드가 없으므로 개인 정보, 고객 기록, 재무 데이터가 담긴 CSV도 안전하게 사용할 수 있습니다.

프라이버시·보안 철학

대부분의 온라인 파일 도구는 파일을 서버에 업로드해 처리한 뒤 결과를 반환하는 방식으로 동작합니다. 이 경우 데이터가 네트워크를 통해 전송되고 외부 인프라에 일시 저장되며, 해당 서비스의 개인정보 처리방침과 데이터 보존 규칙의 적용을 받습니다.

CSV 체커는 다른 접근 방식을 취합니다. 모든 처리가 브라우저 안에서 JavaScript File API, FileReader, TextDecoder를 사용해 이루어집니다. 파일 바이트는 기기를 벗어나지 않습니다. 백엔드 처리 단계도, 임시 저장도, 전송도 없습니다. 브라우저 네트워크 탭을 열고 도구를 실행하면 파일 데이터를 담은 외부 요청이 발생하지 않는 것을 직접 확인할 수 있습니다.

개인 정보(이름, 이메일, ID), 재무 기록, 또는 제3자 서비스와 공유되어서는 안 되는 내부 업무 정보가 담긴 파일을 다룰 때 특히 중요한 부분입니다.

다른 CSV 도구와의 차이

업로드 불필요. 대부분의 브라우저 기반 CSV 도구는 파일을 서버로 업로드합니다. CSV 체커는 도구의 기술적 구조 자체로 모든 것이 로컬에서 처리됩니다. 마케팅 문구가 아닌 기술적 제약입니다.
데이터 품질에 집중. 많은 CSV 변환 도구는 형식 변환은 처리하지만 데이터 품질은 다루지 않습니다. CSV 체커는 가져오기 실패의 원인이 되는 문제들 — 보이지 않는 문자, 중복 키, 인코딩 불일치, 열 수 변동 — 을 전문적으로 검사합니다.
2파일 차이 뷰. 색상으로 구분된 추가·삭제·변경 행의 나란히 보기 CSV 비교는 무료 도구에서 찾기 어렵습니다. CSV 체커는 이를 브라우저에서 제공합니다.
한 곳에 여러 도구. 인코딩 변환, 형식 검사, 중복 감지, 파일 비교를 위해 각각 다른 도구를 쓸 필요 없이 하나의 URL에서 모두 이용할 수 있습니다.

기술적 접근 방식

CSV 체커는 정적 웹 애플리케이션입니다. 데이터를 처리하는 서버 측 코드가 없습니다. 도구는 바닐라 JavaScript로 구축되어 있으며 다음 브라우저 API를 사용합니다:

File API / FileReader — 로컬 파일 시스템에서 파일 바이트를 브라우저 메모리로 직접 읽어옵니다.
TextDecoder — 감지되거나 지정된 문자 인코딩(UTF-8, Shift-JIS, EUC-KR, CP949, Windows-1252 등)으로 바이트를 디코딩합니다.
Blob / URL.createObjectURL — 서버 왕복 없이 메모리 내에서 다운로드 가능한 출력 파일을 생성합니다.

처리는 기기의 CPU에 의존하므로 매우 큰 파일(수십만 행)은 느릴 수 있습니다. 그런 경우 CSV 분할로 먼저 작은 단위로 나눠 처리하세요.

동작 환경

최적의 경험을 위해 최신 버전의 Google Chrome 또는 Microsoft Edge 사용을 권장합니다. 이 브라우저들이 도구가 의존하는 File API와 TextDecoder를 가장 완전하게 지원합니다. 대부분의 최신 브라우저(Firefox, Safari)에서도 동작하지만, 테스트는 덜 자주 이루어집니다.

피드백·문의

CSV 체커는 개인 프로젝트이며 지속적으로 유지·관리됩니다. 버그 발견, 기능 요청, 도구가 올바르게 처리하지 못하는 파일이 있다면 youiny7@gmail.com으로 연락해 주세요. 파일 구조, 예상 동작과 실제 동작을 포함한 구체적인 내용이 가장 큰 도움이 됩니다.

처음으로