JetBrains IDE 한글 언어팩이 안 먹을 때, 설정 위치가 바뀌었다

PhpStorm이나 IntelliJ에서 한글 언어팩을 켰는데 UI가 그대로 영어인 경우가 있다. 캐시를 지워도, IDE를 재시작해도 안 바뀐다.

원인은 단순한데 찾기가 어렵다. 언어팩을 enable 하는 것과, 실제로 사용할 언어를 고르는 것이 별개가 됐기 때문이다.

무엇이 바뀌었나

예전에는 한글 언어팩이 마켓플레이스에서 설치하는 플러그인이었다. 설치하면 곧바로 적용됐다.

그런데 언어팩이 IDE에 기본 번들로 들어오면서 설치/삭제가 아니라 enable / disable 방식으로 바뀌었다. 여기서 함정이 생긴다. enable은 "이 언어팩을 쓸 수 있게 해달라"는 뜻이지 "이 언어로 바꿔달라"는 뜻이 아니다.

해결 순서

1. 언어팩을 enable 한다

Settings (Preferences) > Plugins > Installed 탭
→ "Korean Language Pack / 한국어 언어 팩" 검색
→ 체크박스 활성화

여기까지는 대부분 한다. 문제는 다음 단계다.

2. 실제 사용 언어를 지정한다

Settings > Appearance & Behavior > System Settings > Language and Region
→ Language 항목에서 한국어 선택
→ Apply 후 IDE 재시작

언어팩이 enable 되어 있어야 이 드롭다운에 한국어 항목이 나타난다. enable 안 된 상태에서는 목록에 아예 안 보이므로, 1번을 먼저 하고 2번으로 가는 순서가 중요하다.

영어로 되돌리고 싶을 때도 같은 위치에서 English를 고르면 된다.

그래도 안 될 때 확인할 것

언어팩 버전이 IDE 버전과 안 맞는 경우

JetBrains 언어팩은 IDE 메이저 버전에 맞춰 나온다. IDE를 업데이트했는데 언어팩이 예전 버전이면 적용이 안 되거나 일부만 번역된다. Plugins 화면에서 업데이트가 있는지 확인한다.

설정이 저장 안 되는 경우

여러 JetBrains IDE를 쓰면 설정 디렉터리가 제품·버전별로 따로 있다. 한쪽에서 바꾼 게 다른 쪽에 반영되지 않는 건 정상이다.

# macOS
~/Library/Application Support/JetBrains/<Product><Version>/

# Windows
%APPDATA%\JetBrains\<Product><Version>\

# Linux
~/.config/JetBrains/<Product><Version>/

그래도 안 되면 캐시 무효화

File > Invalidate Caches... > Invalidate and Restart

순서상 이건 마지막에 시도한다. 인덱스를 다시 만들기 때문에 대형 프로젝트에서는 시간이 꽤 걸린다.

한글 UI를 권할지에 대한 개인적인 생각

한 가지 짚고 넘어갈 게 있다. 한글 UI가 항상 좋은 건 아니다.

• 검색이 어려워진다. 문제가 생겨서 검색할 때 대부분의 자료가 영문 메뉴 기준이다. "Invalidate Caches"를 "캐시 무효화"로 보고 있으면 매칭이 안 된다.
• 공식 문서와 어긋난다. JetBrains 공식 문서, 라라캐스트 같은 강의 영상은 전부 영문 UI다.
• 일부 항목은 번역이 안 돼 섞여 나온다. 플러그인이 제공하는 메뉴는 영문 그대로인 경우가 많다.

그래서 나는 IDE UI 자체는 영문으로 두고, 대신 단축키를 외우는 데 시간을 쓰는 쪽을 권한다. 메뉴를 읽을 일 자체가 줄어든다. 처음 진입 장벽 때문에 한글이 필요하다면 켜두고, 익숙해지면 영문으로 돌아가는 것도 방법이다.

정리

• 언어팩 enable과 언어 선택은 별개 단계다
• Plugins에서 enable → Appearance & Behavior > System Settings > Language and Region에서 한국어 선택
• enable 안 하면 언어 드롭다운에 한국어가 안 뜬다
• IDE 업데이트 후에는 언어팩 버전도 확인
• 캐시 무효화는 마지막 수단