프리랜서개발

10월 연휴 전 앱 업데이트 배포: 다국어 번역 JSON 파일의 쉼표·괄호 오류 1초 만에 찾고 정렬하기

세눌라 컴퍼니 · 2026-09-23 · 6분 읽기

연휴 직전 배포에서 다국어 번역 파일이 꼬이는 이유

추석이나 한글날 같은 10월 황금연휴를 앞둔 시점에는 많은 개발팀이 분주해집니다. 연휴 동안 이용자가 몰릴 것에 대비해 신규 이벤트 프로모션을 적용하고 다국어 안내 문구를 담은 앱 업데이트를 미리 배포해야 하기 때문입니다. 예를 들어 10월 2일 오후 4시 배포 마감을 앞두고 기획팀과 외부 번역가가 협업용 스프레드시트에 작성한 한국어와 영어 안내 문구를 취합하는 상황을 떠올려 볼 수 있습니다. 시트에서 내려받은 번역 데이터를 앱 프로젝트용 언어팩 파일인 locale_ko.json과 locale_en.json(각 1,420줄)으로 변환해 소스코드 저장소에 병합하는 과정에서 예상치 못한 문제가 자주 터집니다.

다양한 직군이 동시에 여러 언어의 문구를 수정하다 보면 문장 끝에 불필요한 따옴표가 들어가거나 특수문자 처리가 어긋나기 쉽습니다. 특히 스프레드시트의 빈 행이나 마지막 항목 뒤에 남겨진 끝 쉼표(Trailing Comma)는 육안으로 식별하기 어렵습니다. 표준 JSON 규격은 아주 작은 문법 결함도 용납하지 않으므로 이런 쉼표 하나 때문에 파싱 자체가 완전히 멈춥니다. 배포 직후 모바일 앱이 실행 단계에서 튕기거나 화면에 텍스트 대신 빈 상자만 뜨는 장애로 번집니다.

쉼표 하나와 괄호 쌍이 일으키는 파싱 중단

문법 오류가 가장 빈번하게 발생하는 또 다른 영역은 원격 구성 파일입니다. 예를 들어 이벤트 팝업과 할인 쿠폰 노출 여부를 제어하는 remote_config.json(850줄, 약 42KB) 파일을 수정할 때가 대표적입니다. 마케팅팀의 요청으로 배너 이미지 링크와 유효 기간 배열 객체를 새로 복사해 붙여넣다 보면 닫는 중괄호 }나 대괄호 ]의 짝이 맞지 않는 일이 흔합니다.

자바스크립트나 파이썬 같은 언어는 문장 끝 쉼표를 너그럽게 넘어가기도 하지만 엄격한 표준 JSON 파서는 쉼표 뒤에 유효한 다음 키-값 쌍이 없으면 즉시 문법 해석을 중단합니다. 1,000줄이 훌쩍 넘는 파일에서 줄바꿈이 빽빽하게 이어져 있으면 어디서 괄호가 열리고 닫혔는지 눈으로 일일이 대조하기란 불가능에 가깝습니다. 빌드 스크립트가 모호한 오류 메시지만 남기고 멈춰 서면 배포 담당자는 마감 시한을 앞두고 극심한 시간 압박을 받게 됩니다.

오류 줄과 칸 번호를 브라우저에서 즉시 찾는 법

수천 줄에 달하는 설정 파일에서 깨진 부분을 찾느라 시간을 허비할 필요는 없습니다. 이럴 때는 브라우저에서 곧바로 구문을 분석해 주는 JSON 정렬·검증 도구에 파일 내용을 붙여넣으면 문법 오류가 일어난 정확한 줄(Line) 번호와 칸(Column) 번호를 즉각 짚어 줍니다. 붉은색 표시와 함께 오류 지점의 앞뒤 문맥 코드를 나란히 펼쳐 보여주므로 쉼표가 더 들어갔는지 괄호가 빠졌는지 1초 만에 파악할 수 있습니다.

수정 작업을 진행할 때는 텍스트 에디터에서 직접 찾으려 애쓰기보다 표시된 오류 위치를 기준으로 잘못 들어간 끝 쉼표를 지우거나 누락된 괄호 쌍을 맞추어 주는 방식으로 접근합니다. 외부 서버로 파일이 전송되지 않고 브라우저 메모리 안에서만 검증이 끝나므로 사내 보안 규정을 지켜야 하는 업무용 PC에서도 안심하고 다룰 수 있습니다.

들여쓰기 맞춤과 키 알파벳 정렬로 병합 충돌 방지

문법 오류를 고치고 나면 들여쓰기 스타일을 통일해야 합니다. 개발자마다 에디터 기본 설정이 달라 어떤 사람은 2칸 들여쓰기를 쓰고 다른 사람은 4칸이나 탭(Tab)을 사용하면 소스코드 저장소에서 병합할 때 수백 줄의 충돌(Git Conflict)이 일어납니다. 검증 도구 상단의 들여쓰기 옵션에서 프로젝트 표준에 맞는 간격을 고른 뒤 버튼을 누르면 전체 파일의 공백이 깔끔하게 정돈됩니다.

언어팩을 관리할 때는 키 이름을 알파벳순으로 정렬해 주는 기능이 큰 힘을 발휘합니다. 예를 들어 locale_ko.json에는 존재하는 번역 키가 locale_en.json에 빠져 있는지 대조할 때 두 파일의 키를 알파벳순으로 똑같이 맞춰 두면 좌우 화면을 나란히 놓고 비교하기가 무척 쉬워집니다. 누락된 문구를 사전에 발견할 수 있어 번역이 빠진 채 영어권 사용자에게 한국어가 노출되는 실수도 미리 막아 줍니다.

연휴 배포 전에는 언어팩 키 목록을 알파벳순으로 정렬해 둔 뒤 깃(Git) 변경 사항을 비교하세요. 다른 팀원이 추가한 새 문구가 누락되었는지 한눈에 파악할 수 있습니다.

한 줄 압축과 구조 통계로 배포 전 무결성 검증

모바일 앱 환경에서는 네트워크 전송 데이터양을 1KB라도 줄이는 최적화가 필수입니다. 배포용 설정 파일의 용량을 최소화하고 싶을 때도 JSON 정렬·검증 의 한 줄 압축 기능을 쓰면 파일 안의 불필요한 공백과 줄바꿈 문자를 완전히 제거해 줍니다. 42KB였던 설정 파일이 28KB 안팎으로 가벼워져 앱 초기 로딩 속도를 높이는 데 보탬이 됩니다.

압축을 적용하기 직전에는 데이터 구조 통계를 꼼꼼히 살피는 과정이 좋습니다. 도구 화면에 표시되는 전체 키 개수, 배열 개수, 데이터의 최대 깊이(Depth), 글자 수를 원본 파일과 대조해 봅니다. 복사나 잘라내기 과정에서 실수로 특정 데이터 덩어리가 유실되지 않았는지 숫자로 바로 검증할 수 있어 배포 안정성을 크게 높여 줍니다.

번역 파일 수정 시 자주 하는 실수와 점검 기준

배포 직전에 급하게 번역 파일을 손보다 보면 자주 반복되는 실수가 정해져 있습니다. 다음 표를 바탕으로 소스코드 병합 전 필수 점검 항목을 확인해 보세요.

자주 묻는 질문

JSON5나 YAML 파일도 이 도구에서 정렬할 수 있나요?

지원하지 않습니다. 이 도구는 표준 JSON 규격만을 엄격하게 검증하고 다루도록 만들어졌습니다. 주석이나 끝 쉼표를 허용하는 JSON5 형식이나 YAML, XML 문서는 표준 JSON과 문법 구조가 다르므로 변환이나 검증을 지원하지 않습니다. 표준 JSON 문법을 맞추는 용도로만 사용해야 합니다.

입력한 데이터가 사외 서버로 유출될 염려는 없나요?

전혀 없습니다. 모든 구문 분석과 정렬 연산은 브라우저 내부 자바스크립트 엔진 안에서만 일어납니다. 입력한 텍스트는 네트워크를 타고 외부 서버로 전송되지 않으며 페이지를 새로고침할 때를 대비해 사용자의 브라우저 로컬 저장소에만 최대 20만 자까지 보관됩니다. 인터넷 연결을 끊은 상태에서도 동일하게 동작합니다.

문법 검증 후 파일은 어떻게 저장하나요?

정렬이나 압축이 끝난 결과물은 화면의 복사 버튼을 눌러 클립보드에 담은 뒤 코드 편집기에 붙여넣을 수 있습니다. 또는 파일 저장 버튼을 눌러 정돈된 .json 확장자 파일로 직접 내려받아 프로젝트 폴더에 덮어쓸 수도 있습니다.

안정적인 연휴 배포를 위한 최종 점검

배포 마감 시각이 다가올수록 사소한 실수 하나가 긴 연휴 동안의 긴급 호출로 이어지기 쉽습니다. 소스코드 저장소에 병합하기 직전 JSON 정렬·검증 으로 문법 오류를 잡고 코드 스타일을 통일해 두면 불필요한 빌드 실패와 런타임 크래시를 확실히 막아 줍니다. 꼼꼼한 사전 점검으로 편안하고 여유로운 연휴를 맞이하시기 바랍니다.