이런 경우 대부분 입력기(fcitx) 설정 문제인 경우가 많습니다.
이번 글에서는 우분투에서 fcitx를 이용해 한글 입력을 정상적으로 사용하는 방법을 단계별로 정리해보겠습니다.

🐧 fcitx란 무엇인가?

**fcitx**는
리눅스에서 사용하는 입력기 프레임워크로,
한글·중국어·일본어 등 다양한 언어 입력을 지원합니다.

우분투에서는 기본 입력기 대신 fcitx + 한글 엔진 조합을 많이 사용합니다.

1️⃣ fcitx 및 한글 입력기 설치

터미널을 열고 아래 명령어를 순서대로 실행합니다.

sudo apt update
sudo apt install fcitx fcitx-hangul -y

설치가 끝나면 로그아웃 또는 재부팅을 권장합니다.

2️⃣ 입력기 시스템을 fcitx로 변경

입력기 설정 열기

• 설정(Settings) → 지역 및 언어(Region & Language)
• 또는 터미널에서:

im-config

설정 방법

1. 입력기 선택 창에서 fcitx 선택
2. 확인 → 로그아웃 또는 재부팅

📌 이 단계가 빠지면 설치해도 한글 입력이 안 됩니다.

3️⃣ fcitx 설정에서 한글 추가하기

설정 열기

fcitx-configtool

한글 입력기 추가

1. Input Method 탭 이동
2. + 버튼 클릭
3. “Only Show Current Language” 체크 해제
4. 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, 터미널, 브라우저 어디서든
문제없이 한글 입력이 가능합니다.

게시물 우분투 fcitx 한글 설치 방법 (한글 입력 안 될 때 해결)이 하우인포-IT·테크에 처음 등장했습니다.