문자열 이스케이프 변환기

₩와 백슬래시

한국어 Windows의 코드 페이지 949에서는 0x5C 자리가 원화 기호이고, 시스템 글꼴을 포함한 여러 글꼴이 지금도 백슬래시를 ₩로 그립니다. 그래서 경로는 C:₩Program Files₩, 줄 바꿈 이스케이프는 ₩n처럼 보입니다(Won sign, Wikipedia; Michael Kaplan의 글 When is a backslash not a backslash?). 화면에 보이는 대로 다시 입력하면 진짜 원화 기호 ₩(U+20A9)가 들어갈 수 있습니다.

이 텍스트를 Java → 언이스케이프에 넣어도 ₩n은 줄 바꿈이 되지 않습니다. U+20A9는 이스케이프 문자가 아니기 때문입니다. 도구는 텍스트를 바꾸지 않고, “₩n은 백슬래시가 아니라 ₩(U+20A9)로 시작한다”고 알려 줍니다. 전각 ￦(U+FFE6)와 ＼(U+FF3C)도 같은 방식으로 찾아냅니다.

한글이 \uXXXX로 보일 때

Python의 json.dumps는 기본값이 ensure_ascii=True라서 json.dumps({"name": "홍길동"})의 결과가 {"name": "\ud64d\uae38\ub3d9"}입니다(json 모듈 문서). 로그에서 이 값이 다시 문자열로 감싸져 따옴표까지 이스케이프되어 있다면 JSON → 언이스케이프를 씁니다.

입력: {\"name\":\"\ud64d\uae38\ub3d9\"}
출력: {"name":"홍길동"}

반대로 ‘비 ASCII 문자를 \uXXXX로’를 켜고 이스케이프하면 안녕 → \uc548\ub155처럼 json.dumps 기본 출력과 같은 형태가 됩니다. 이 옵션을 끄면 브라우저의 JSON.stringify와 똑같이 한글을 그대로 둡니다. 두 경우 모두 테스트 스크립트가 Python과 브라우저의 결과를 하나하나 비교합니다.

셸 인수와 한글 파일명

작은따옴표가 들어간 파일명을 셸 명령에 넣을 때는 셸 → 이스케이프가 Python shlex.quote와 같은 결과를 냅니다.

거꾸로 $HOME/notes.txt를 언이스케이프하면 오류가 납니다. $HOME은 셸이 실행 환경에 따라 바꾸는 값이라 하나의 결과로 정할 수 없기 때문입니다. bash의 printf %q가 내놓는 hello\ world\!나 $'a\nb' 같은 형태는 그대로 풀어 줍니다.

형식별 규칙과 검증

검증 스크립트는 저장소의 scripts/test-string-escape.mjs입니다. 자주 틀리는 부분도 여기서 확인합니다. JavaScript에서 NUL 뒤에 숫자가 오면 \x00으로 써야 하고(\0 다음에 1이 오면 예전 8진수 \01이 되어 strict 모드에서 SyntaxError), Java에서 줄 바꿈은 \u000a가 아니라 \n으로 써야 하며, HTML에서 😀는 참조 하나 😀로 써야 합니다.

오류와 안내

SQL 형식에서는 “이스케이프로는 SQL 인젝션을 확실히 막을 수 없다”는 OWASP의 안내를 항상 함께 보여 줍니다(OWASP SQL Injection Prevention Cheat Sheet). CSV 값이 =, +, -, @로 시작하면 스프레드시트가 수식으로 실행할 수 있다고 알리고(OWASP CSV Injection), ‘수식 방지’에서 OWASP가 제시한 두 방법(' 붙이기, 탭 붙이기) 중 하나를 고를 수 있습니다.

다른 도구와 비교

2026-10-01 데스크톱 Chromium에서 Bing의 ‘이스케이프 변환’ 상위 도구를 같은 입력으로 시험했습니다.

• devlab.itlibra.com: ‘HTML entities (all non-ASCII)‘로 😀를 ��처럼 UTF-16 반쪽 참조 두 개로 바꿉니다. 브라우저는 이를 대체 문자 두 개로 표시합니다. JavaScript 언이스케이프에서 \x4는 오류 없이 그대로 남습니다.
• codertools.net(한국어 페이지 제공): JavaScript 이스케이프에서 NUL 뒤에 1이 오면 a\01을 냅니다. \u{1F600}과 JSON의 \q는 아무 안내 없이 그대로 돌려줍니다.

이 도구는 같은 입력에 대해 😀, \x001, 위치가 붙은 오류를 돌려주며, 텍스트를 외부로 보내지 않습니다.

관련 도구

이스케이프하기 전에 보이지 않는 문자가 섞였는지 확인하려면 보이지 않는 문자 감지기, 퍼센트 인코딩은 URL 인코드 / 디코드, 엔티티 목록은 HTML 엔티티 인코더 / 디코더, 이스케이프한 패턴 확인은 정규식 테스터를 쓰세요.

제한 사항

• 입력은 하나의 문자열 값으로 다룹니다. CSV 언이스케이프는 필드 하나, 셸 언이스케이프는 인수 하나만 읽습니다.
• Python의 \N{이름}은 Unicode 문자 이름표가 필요해 지원하지 않습니다(오류로 \u / \U를 안내).
• HTML 이스케이프는 본문과 따옴표로 감싼 속성 값용입니다. <script> 안의 JavaScript, CSS, URL은 각각 다른 규칙이 필요합니다.
• 정규식 이스케이프는 문자 클래스 [...] 밖에서 쓰는 것을 전제로 합니다.
• XML 1.0에서 쓸 수 없는 문자(대부분의 C0 제어 문자, U+FFFE, U+FFFF, 짝 없는 서로게이트)는 이스케이프할 수 없어 오류로 알립니다.