Unicode Escape ↔ Text 변환기

Unicode Escape ↔ Text 변환기란?

Unicode Escape ↔ Text 변환기는 개발 중 자주 만나는 이스케이프 문자열을 사람이 읽을 수 있는 텍스트로 복원하거나, 일반 텍스트를 이스케이프 시퀀스로 안전하게 변환하는 도구입니다. 특히 로그 분석, API 페이로드 확인, 코드 리뷰에서 눈으로 확인하기 어려운 문자열을 빠르게 해석하는 데 초점을 맞췄습니다.

이 도구는 단순 치환이 아니라 토크나이저 기반 해석을 사용해 \uXXXX, \xXX, \u{…}를 구분하고, 잘못된 토큰의 위치와 원인을 함께 보여줍니다. 따라서 결과 문자열만 보는 흐름이 아니라, 어떤 구간에서 문제가 생겼는지까지 한 번에 점검할 수 있습니다.

이런 상황에서 활용해 보세요

문자열 디버깅은 결과 값만 바뀌는 문제가 아니라, 인코딩 규칙과 입력 품질이 동시에 영향을 줍니다. 아래 사례처럼 정책과 위치 기반 점검이 필요한 순간에 가장 효과적입니다.

• 서버 로그의 \uXXXX 값이 실제 어떤 문자로 표시되는지 즉시 확인해야 할 때
• 프론트엔드에서 전송하는 텍스트를 API 계약에 맞는 escape 포맷으로 변환해야 할 때
• 복수 백슬래시(\\)가 섞인 문자열에서 리터럴과 실제 escape를 구분해야 할 때
• surrogate pair가 깨져 이모지/보조평면 문자가 손상되는 원인을 찾아야 할 때
• 오류 위치를 QA 티켓에 정확히 남기고 재현 가능한 증적을 공유해야 할 때

주요 기능

변환 정확성과 리뷰 가독성을 동시에 확보할 수 있도록, 결과 요약과 진단 정보를 한 화면에서 단계적으로 확인할 수 있게 구성했습니다.

• 양방향 변환: Escape → Text, Text → Escape를 즉시 전환합니다.
• 다중 escape 지원: \uXXXX, \xXX, \u{...} 형식을 동일 입력에서 함께 처리합니다.
• strict/lenient 정책: invalid escape를 오류로 강조하거나 리터럴 유지 경고로 처리합니다.
• 오류 위치/건수 표시: line:column, index, 원본 토큰, 메시지를 표로 제공합니다.
• 요약 카드 + 결과 탭: 입력 단위·변환 성공·이슈 수·출력 길이를 한눈에 보여줍니다.
• 상세 변환 표: 토큰 단위 입력/출력/코드/상태를 행 단위로 추적할 수 있습니다.
• 다운로드 버튼: 결과 텍스트, 오류 CSV, 코드포인트 CSV를 즉시 저장할 수 있습니다.

사용 방법

1. 변환 방향을 먼저 선택합니다. Escape 해석이 목적이면 Escape → Text, 이스케이프 생성이 목적이면 Text → Escape를 사용합니다.
2. Escape 해석 시에는 strict/lenient 정책을 정하고, Text 인코딩 시에는 출력 포맷(\uXXXX, \u{...}, \xXX 혼합)을 선택합니다.
3. 입력 텍스트를 붙여넣고 Convert를 클릭하면 결과 영역으로 자동 스크롤되며 요약 카드와 탭이 업데이트됩니다.
4. 오류 목록 탭에서 위치·건수를 먼저 확인한 뒤, 코드포인트 탭과 상세 표로 원인을 좁혀 검토합니다.
5. 검토를 마치면 다운로드 버튼으로 증적 파일을 내보내거나, 현재 탭 복사 기능으로 이슈 리포트에 바로 붙여넣습니다.

리셋 버튼은 입력·옵션·결과를 모두 초기 상태로 되돌리므로, 서로 다른 케이스를 연속 검증할 때 오염 없이 반복 테스트를 수행할 수 있습니다.

토크나이저 기준과 해석 규칙

디코드 과정은 문자열을 문자 단위가 아니라 토큰 단위로 스캔합니다. 백슬래시 연속(\\)은 리터럴 백슬래시로 처리하고, \uXXXX/\xXX/\u{...} 패턴은 각각 독립 검증한 뒤 변환합니다. 이 구조 덕분에 부분 손상 입력에서도 문제 구간을 정확히 분리해 표시할 수 있습니다.

surrogate pair는 고/저 대리쌍이 연속으로 등장할 때만 결합합니다. high surrogate 단독, low surrogate 단독, 범위를 벗어난 code point는 strict에서는 오류로, lenient에서는 원문 보존 경고로 기록해 디버깅과 복구 두 시나리오를 모두 지원합니다.

기준 확인일: 2026-03-04
참고 문서: ECMAScript String Literals, MDN Character escape, Unicode FAQ (UTF / surrogate).

자주 묻는 질문