Hangul.js

Hangul.js는 한글 자음/모음 분리·조합을 처리하는 자바스크립트 라이브러리입니다. 한글 오토마타 구현체입니다.

GitHub 현황 (2026년 8월 기준)

• 스타 713 · 포크 94
• 라이선스 MIT · 저장소 e-/Hangul.js · 마지막 push 2025-03-27

한글 조합이 프로그래밍에서 까다로운 이유

한글은 자음과 모음이 모여 한 글자가 됩니다. “한”은 유니코드에서 한 글자지만 ㅎ+ㅏ+ㄴ으로 쪼갤 수 있습니다. 영어에는 없는 층이라 대부분의 문자열 함수가 이걸 모릅니다.

그래서 초성 검색(“ㄱㄷ”로 “가ददdd”… 같은 기능)이나 타이핑 중간 상태 처리를 직접 만들려면 유니코드 계산부터 해야 합니다.

실제로 쓰이는 곳

• 초성 검색: 연락처·메뉴에서 “ㅎㄱ”으로 “한국” 찾기
• 자동완성: 조합 중인 글자를 어떻게 취급할지
• 오타 교정: 자모 단위 거리 계산
• 게임·교육: 한글 타자 연습

그리고 옛한글·확장 자모는 지원 범위를 확인해야 합니다. 현대 한글만 다루는 구현이 많고, 고문헌이나 특수 표기를 처리하려면 별도 검토가 필요합니다.

함께 볼 한국어 처리 오픈소스

• soynlp: 사전 없이 통계로 단어를 찾아내는 비지도 방식
• KoAlpaca: 한국어 명령어를 이해하는 오픈소스 언어모델
• im-not-ai: 한국어 글에서 번역투·기계적 대구를 찾아 고침
• Kiwi: 형태소 분석기(C++ 코어)
• KSS: 문장 분리를 비롯한 문자열 처리 스위트
• 가루(garu): 형태소·용언 처리
• Hangulize: 외국어를 한글 표기로 변환

Hangul.js는 이 중 가장 낮은 층에 있습니다. 나머지가 “단어와 문장”을 다룬다면 이쪽은 글자 이전, 자모 단위를 다룹니다. 형태소 분석을 붙이기 전에 초성 검색만 필요한 경우가 실제로는 더 많습니다.

이런 분께 맞아요

• 초성 검색을 붙이려는 프론트엔드 개발자
• 한글 입력·조합을 직접 처리해야 하는 앱
• 자모 단위 오타 교정이 필요한 서비스
• 한글 유니코드 구조를 배우려는 학습자