iTerm2에서 한글 깨짐 해결하기

문제 상황

macOS에서 iTerm2를 사용하다 보면 한글 파일명이나 디렉토리명이 깨져 보이는 경우가 있습니다. ls 명령어를 실행했을 때 한글이 자음과 모음으로 분리되어 표시되거나, git 명령어에서 한글 파일명이 이상하게 출력되는 현상입니다.

이 문제는 macOS의 파일 시스템이 NFD(Normalization Form Decomposition) 방식을 사용하는 반면, 대부분의 한글 처리 시스템은 NFC(Normalization Form Composition) 방식을 기대하기 때문에 발생합니다.

원인 분석

유니코드에서 한글을 표현하는 방식은 두 가지가 있습니다.

• NFC (Composed): 완성형. "한" → U+D55C (한 글자로 저장)
• NFD (Decomposed): 분해형. "한" → U+1112 + U+1161 + U+11AB (ㅎ + ㅏ + ㄴ으로 분리 저장)

macOS의 HFS+ 및 APFS 파일 시스템은 NFD 방식으로 파일명을 저장합니다. iTerm2가 이를 그대로 출력하면 한글이 자소 단위로 분리되어 보이게 됩니다.

해결 방법

iTerm2의 텍스트 정규화 설정을 NFC로 변경하면 됩니다.

설정 순서

1. 설정 열기: Command + , (쉼표) 단축키로 Preferences 창을 엽니다
2. Profiles 탭: 상단 메뉴에서 Profiles를 선택합니다
3. Text 탭: 프로필 설정 중 Text 탭으로 이동합니다
4. Unicode normalization: 하단의 Unicode normalization 옵션을 찾습니다
5. NFC로 변경: 드롭다운에서 NFC를 선택합니다

설정 변경 후 새 터미널 탭을 열면 한글이 정상적으로 표시됩니다. 기존 탭에서는 변경이 적용되지 않을 수 있으니, 새 탭에서 확인해 보세요.

추가 팁

git에서 한글 파일명 문제

git에서도 한글 파일명이 이상하게 표시되는 경우가 있습니다. 이때는 아래 설정을 추가합니다.

git config --global core.quotepath false

이 설정은 git이 비ASCII 문자를 이스케이프하지 않도록 합니다.

Zsh에서 한글 입력 문제

Zsh를 사용할 때 한글 입력이 잘 안 되는 경우, .zshrc에 다음을 추가합니다.

export LANG=ko_KR.UTF-8
export LC_ALL=ko_KR.UTF-8

정리

macOS에서 한글 깨짐 현상은 유니코드 정규화 방식의 차이에서 발생합니다. iTerm2에서는 Profiles > Text > Unicode normalization > NFC 설정 하나로 해결할 수 있습니다. 개발 환경을 한국어로 사용한다면 반드시 확인해두면 좋은 설정입니다.