리눅스로 개발 환경을 옮기는 순간 가장 먼저 마주치는 고통이 있습니다. 바로 한글 입력기입니다. 윈도우에서는 당연하게 눌렸던 한/영 키가 데비안(Debian) 설치 직후에는 아무 반응도 없거나, 간신히 입력이 되다가도 VS Code나 Chrome 주소창에서 갑자기 글자가 깨져 나옵니다.
저도 Debian 12 서버에 데스크탑 환경을 붙이며 이 문제를 꽤 오래 파고든 적이 있습니다. 기본 입력기인 ibus를 그냥 두면 Chromium 계열 앱과 충돌이 잦았고, fcitx4는 더 이상 활발히 유지보수가 안 됩니다. 결국 Fcitx5 + fcitx5-hangul 조합이 2025~2026년 기준 가장 안정적인 해법이라는 결론에 이르렀습니다. 이 글에서는 설치부터 각종 오류 해결까지 한 번에 정리합니다.
🔹 1. Fcitx5란? — ibus와 무엇이 다른가
Fcitx(Free Chinese Input Toy for X)는 리눅스의 대표적인 입력기 프레임워크입니다. 5버전부터 Wayland를 공식 지원하고 아키텍처가 전면 재설계되어 반응 속도와 안정성이 크게 향상되었습니다. 데비안·우분투의 기본 입력기인 ibus와 비교하면 다음과 같은 차이가 있습니다.
| 항목 | ibus | Fcitx5 |
|---|---|---|
| Wayland 지원 | 제한적 | ✔ 공식 지원 |
| Chromium 계열 앱 호환 | 충돌 잦음 | ✔ 안정적 |
| JetBrains IDE 호환 | 충돌 (2018년~) | ✔ 호환 개선 |
| 유지보수 상태 | GNOME 의존성 강함 | ✔ 활발히 개발 중 |
🔹 2. Debian 12 Fcitx5 설치 — 명령어 3줄
터미널을 열고 아래 명령어를 순서대로 실행합니다. 인터넷이 연결된 상태라면 3~5분 안에 설치가 완료됩니다.
sudo apt update && sudo apt upgrade -y
sudo apt install -y fcitx5 fcitx5-hangul fcitx5-config-qt
sudo apt install -y fonts-nanum fonts-noto-cjk각 패키지의 역할은 다음과 같습니다.
- fcitx5 — 입력기 프레임워크 본체
- fcitx5-hangul — 한글 입력 엔진 (libhangul 기반)
- fcitx5-config-qt — GUI 설정 도구 (fcitx5-configtool 명령으로 실행)
- fonts-nanum, fonts-noto-cjk — 한글 폰트 (설치 안 하면 글자가 깨져 보임)
sudo apt remove --purge ibus ibus-hangul🔹 3. 한글 입력기 등록 및 한영전환 키 설정
설치 후 반드시 아래 두 가지 설정을 해야 실제로 한글 입력이 됩니다.
im-configfcitx5-configtool1. "입력기" 탭 → + 버튼으로 Hangul 추가
(목록에 안 보이면 하단의 "현재 언어만 표시" 체크 해제)
2. "전역 옵션" 탭 → Trigger Input Method 항목에서 한/영 키 추가
(기본값은 Ctrl+Space인데, 한/영 키를 추가로 등록해야 일반 키보드에서 작동)
🔹 4. 핵심 트러블슈팅 — 환경변수 설정으로 완전 해결
설치와 설정을 마쳤는데도 일부 앱에서 한글이 입력되지 않는다면 환경변수 누락이 원인인 경우가 대부분입니다. GTK, Qt 앱들은 어느 입력기를 사용할지 환경변수를 보고 판단하기 때문입니다.
/etc/environment 파일을 열어 아래 내용을 추가합니다.
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx
SDL_IM_MODULE=fcitx편집 후 반드시 재부팅해야 변수가 세션 전체에 적용됩니다. source 명령만으로는 데스크탑 환경 전체에 반영되지 않습니다.
- GTK_IM_MODULE=fcitx — Firefox, Chrome, GIMP 등 GTK 앱에 적용
- QT_IM_MODULE=fcitx — KDE Plasma, Qt 앱(VirtualBox 등)에 적용
- XMODIFIERS=@im=fcitx — X11 레거시 앱(LibreOffice 등) 호환을 위해 필요
- SDL_IM_MODULE=fcitx — SDL 기반 게임·앱 대응 (없어도 무방하나 권장)
🔹 5. 앱별 한글 오류 대응
환경변수를 모두 설정해도 특정 앱에서만 문제가 남는 경우가 있습니다. 자주 발생하는 케이스별 해결 방법입니다.
--enable-features=UseOzonePlatform --ozone-platform=wayland 플래그를 추가하거나, X11 모드로 강제 실행하는 방법으로 해결됩니다.code --enable-features=UseOzonePlatform --ozone-platform=x11--gtk-version=4 플래그 제거를 시도해 보세요.XMODIFIERS=@im=fcitx가 /etc/environment에 정확히 들어가 있는지 확인합니다. LibreOffice는 재시작 없이 적용이 안 되므로 완전히 종료 후 재실행합니다."해당 배너는 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."
❓ 6. 자주 묻는 질문
Q. fcitx5 설치 후 트레이 아이콘이 안 보입니다.
im-config 설정이 빠졌거나 fcitx5가 자동 실행되지 않는 것입니다. 터미널에서 fcitx5 &로 수동 실행하고 트레이에 뜨는지 확인한 뒤, im-config 재설정 후 재부팅하세요.
Q. 한영전환은 되는데 특정 앱에서만 한글이 안 됩니다.
환경변수 미설정이 원인입니다. /etc/environment에 GTK_IM_MODULE, QT_IM_MODULE, XMODIFIERS 세 줄을 모두 추가하고 재부팅하면 대부분 해결됩니다. 그래도 안 되는 앱은 앱 자체의 실행 방식(Flatpak, Snap 등)을 확인해야 합니다.
Q. Flatpak이나 Snap으로 설치한 앱에서 한글이 안 됩니다.
Flatpak/Snap은 샌드박스 환경이라 시스템 환경변수가 전달되지 않습니다. Flatpak의 경우 flatpak override --user --env=GTK_IM_MODULE=fcitx 앱ID 명령으로 별도 환경변수를 주입해야 합니다.
Q. 한글 자모 조합 중에 커서가 이상한 위치로 이동합니다.
Fcitx5 설정에서 한글 입력기(Hangul)의 "Use Pre-edit" 옵션을 조정해 보세요. 일부 앱에서 preedit 모드가 커서 위치 오류를 유발합니다. fcitx5-configtool → Hangul 설정 → Enable Preedit in application 옵션 토글로 해결되는 경우가 많습니다.
📋 핵심 요약 — 이 순서대로만 하면 됩니다
sudo apt install fcitx5 fcitx5-hangul fcitx5-config-qt fonts-nanumim-config실행 → fcitx5 선택fcitx5-configtool에서 Hangul 추가, 한/영 키 등록/etc/environment에 환경변수 4줄 추가- 재부팅 → 완료
Debian 12는 안정성 중심의 배포판인 만큼 입력기 환경도 한 번 잘 잡아두면 오래 유지됩니다. 위 순서를 따라 설정한 뒤에도 특정 앱에서 문제가 남는다면, 해당 앱의 설치 방식(네이티브/Flatpak/Snap)과 실행 환경을 먼저 확인하는 것이 핵심입니다.
'IT 관련' 카테고리의 다른 글
| Flutter 현장 앱 개발 | 사진에 GPS EXIF + 메모 동시 저장하는 아키텍처 완전 정리 (0) | 2026.06.09 |
|---|---|
| VS Code·Cursor "Extension Host Terminated" 완전 해결 | 원인 분석부터 단계별 조치까지 (0) | 2026.06.08 |
| 2026 부산 창업·중소기업 지원 정책: 자금부터 DX까지 한눈에 (0) | 2026.06.06 |
| 네이버 글 쓰면 1000만 원 번다? ‘AI 브리핑’ 도입과 어뷰징의 전쟁 시작됐다 (0) | 2026.06.05 |
| 스마트홈의 진화, 이제 알아서 문 열고 음악 튼다! 공간을 해킹하는 대기업들의 'AI 리빙 오케스트라' 경쟁 (0) | 2026.06.04 |
