우분투를 설치한 뒤 가장 많이 겪는 문제 중 하나가
**“한글이 보이긴 하는데 입력이 안 되는 현상”**입니다.
이런 경우 대부분 입력기(fcitx) 설정 문제인 경우가 많습니다.
이번 글에서는 우분투에서 fcitx를 이용해 한글 입력을 정상적으로 사용하는 방법을 단계별로 정리해보겠습니다.
🐧 fcitx란 무엇인가?
**fcitx**는
리눅스에서 사용하는 입력기 프레임워크로,
한글·중국어·일본어 등 다양한 언어 입력을 지원합니다.
우분투에서는 기본 입력기 대신 fcitx + 한글 엔진 조합을 많이 사용합니다.
1️⃣ fcitx 및 한글 입력기 설치
터미널을 열고 아래 명령어를 순서대로 실행합니다.
sudo apt update
sudo apt install fcitx fcitx-hangul -y
설치가 끝나면 로그아웃 또는 재부팅을 권장합니다.
2️⃣ 입력기 시스템을 fcitx로 변경
입력기 설정 열기
- 설정(Settings) → 지역 및 언어(Region & Language)
- 또는 터미널에서:
im-config
설정 방법
- 입력기 선택 창에서
fcitx선택 - 확인 → 로그아웃 또는 재부팅
📌 이 단계가 빠지면 설치해도 한글 입력이 안 됩니다.
3️⃣ fcitx 설정에서 한글 추가하기
설정 열기
fcitx-configtool
한글 입력기 추가
- Input Method 탭 이동
+버튼 클릭- “Only Show Current Language” 체크 해제
- Hangul 또는 Korean 선택 → 추가
4️⃣ 한글 입력 단축키 확인
기본 한/영 전환 키:
- Shift + Space
- 또는 Ctrl + Space
fcitx 설정에서 단축키는 자유롭게 변경할 수 있습니다.
5️⃣ 그래도 한글 입력이 안 될 때 체크사항
✅ 환경변수 확인
echo $GTK_IM_MODULE
echo $QT_IM_MODULE
정상이라면 출력값은:
fcitx
수동 설정 (필요 시)
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
💡 자주 발생하는 원인 정리
- fcitx 설치만 하고 입력기 전환을 안 한 경우
- 로그아웃/재부팅을 하지 않은 경우
- ibus와 fcitx가 충돌하는 경우
👉 im-config → fcitx 선택이 핵심입니다.
✨ 마무리
우분투에서 한글 입력이 안 되는 문제는
대부분 fcitx 설치 + 입력기 전환 설정으로 해결됩니다.
한 번만 제대로 설정해두면
VS Code, 터미널, 브라우저 어디서든
문제없이 한글 입력이 가능합니다.
이 글이 도움이 되었나요?좋아요/추천은 다시 누르면 취소됩니다.
