URL 인코더 / 디코더
한글·공백·특수문자가 포함된 URL을 퍼센트 인코딩하거나 원래 문자로 복원하세요. 쿼리 값과 전체 URL 모드 모두 지원.
URL 인코더 / 디코더
URL에 한글·특수문자를 안전하게 넣기 위해 퍼센트(%) 인코딩하거나 원래 문자로 복원합니다.
결과
URL 인코딩이란?
- 퍼센트 인코딩
- URL에 들어갈 수 없는 한글·공백·특수문자(?, &, /, # 등)를 %XX 형태의 ASCII 안전 문자로 치환하는 방식입니다.
- 값 vs 전체 URL
- · 값(쿼리 파라미터): encodeURIComponent — ?·&·/까지 모두 인코딩. 검색어·파라미터 값에 사용.
· 전체 URL: encodeURI — 구분자(?, &, /)는 그대로 두고 나머지만 인코딩. 한글이 포함된 URL을 통째로 변환할 때 사용. - 처리 방식
- 브라우저 내장 encodeURIComponent / decodeURIComponent (또는 encodeURI / decodeURI)로 처리되며 입력 데이터는 외부로 전송되지 않습니다.
자주 묻는 질문
URL 인코딩은 언제 사용하나요?
한글 검색어를 URL 쿼리 파라미터에 넣을 때, 공백·특수문자가 포함된 값을 API URL에 담아야 할 때, 카카오톡·메신저에 URL을 공유할 때 깨짐을 방지하기 위해 사용합니다. 예: "검색" → "%EA%B2%80%EC%83%89"
encodeURI와 encodeURIComponent 중 무엇을 골라야 하나요?
쿼리 값·검색어처럼 작은 조각만 인코딩한다면 "값(쿼리 파라미터)" 모드(encodeURIComponent)를, 한글이 섞인 URL 전체를 한 번에 변환한다면 "전체 URL" 모드(encodeURI)를 선택하세요. 전자는 ?, &, /도 모두 인코딩하고 후자는 URL 구분자를 그대로 둡니다.
디코딩 시 "URI malformed" 오류가 나는 이유는?
입력에 %로 시작하지만 뒤따르는 16진수 2자리가 잘못된 경우 발생합니다. 예: "%ZZ", "%E"처럼 불완전한 시퀀스. 입력 문자열을 다시 확인하거나, 일부만 인코딩된 문자열이라면 그대로 두는 것이 안전합니다.
한글이 포함된 URL을 카카오톡·문자에 보내도 깨지지 않게 하려면?
"전체 URL" 모드로 한 번 인코딩한 결과를 공유하면 됩니다. 받는 쪽 메신저·브라우저가 자동으로 디코딩해서 원래 한글 URL로 표시해 줍니다.
입력한 URL이 서버로 전송되나요?
아니요. 본 도구는 브라우저 내장 encodeURIComponent / decodeURIComponent 함수로 100% 클라이언트에서 처리합니다. 회사 내부 URL, 토큰이 포함된 URL도 외부로 전송되지 않습니다.