Xubuntu 한글 입력기 설정 완벽 정리 — fcitx5 설치부터 오류 해결까지

Xubuntu를 설치하고 나서 제일 먼저 막히는 게 한글 입력입니다.

터미널을 열고 뭔가 입력하려는데 한글이 안 쳐지는 거예요. 브라우저 주소창도, 텍스트 에디터도 마찬가지고요. 당연히 될 줄 알았는데 안 되니까 당황스럽죠. 저도 처음에 이 부분에서 꽤 헤맸습니다.

리눅스는 기본 설치 상태에서 한글 입력기가 포함되어 있지 않아요. 별도로 설치하고 설정까지 마쳐야 한글을 쓸 수 있습니다. 이 글에서 그 과정을 순서대로 정리할게요.

🔩

1편 — 설치 후기

크롬북 리눅스 설치 완전 정복 — WP나사 찾기부터 Xubuntu 부팅까지

›

⚖️

2편 — OS 선택 가이드

Chrome OS Flex vs Xubuntu — 지원 끊긴 크롬북에 뭘 올려야 할까? [2026 실사용 비교]

›

🌿

3편 — 배포판 비교

경량 리눅스 배포판 비교 — Xubuntu vs Linux Mint, 오래된 노트북엔 뭘 올려야 할까? (2026)

›

📦

4편 — 필수 앱

Xubuntu 설치 후 제일 먼저 깔아야 할 앱 10개 — 크롬북 리눅스 실사용 추천

›

🗂️ 한글 입력기 종류 — 뭘 써야 할까?

리눅스에서 주로 쓰이는 한글 입력기는 두 가지입니다.

입력기	특징	추천 대상
fcitx5 ✓	안정적, 다국어 지원 우수, 활발히 유지보수 중	대부분의 경우 추천
ibus-hangul	설치 간단, Ubuntu 계열 기본 프레임워크	간단하게 쓰고 싶은 분

둘 다 무료고 둘 다 잘 작동합니다. 저는 fcitx5가 더 안정적이었고 오류가 적었어요. 이 글은 fcitx5 기준으로 설명하고, 마지막에 ibus-hangul 방법도 간단히 정리해 뒀으니 참고하세요.

⚙️ fcitx5 설정 — 단계별 순서

01

fcitx5 설치

터미널을 열고 아래 명령어를 입력합니다.

sudo apt install fcitx5 fcitx5-hangul fcitx5-config-qt

fcitx5는 입력기 본체, fcitx5-hangul은 한글 모듈, fcitx5-config-qt는 GUI 설정 도구입니다. 셋 다 같이 설치하는 게 편해요.

02

기본 입력기를 fcitx5로 변경

터미널에서 아래 명령어를 실행합니다.

im-config

GUI 창이 뜨면 순서대로 따라가면 됩니다.

• 1
  "확인(OK)" 클릭
• 2
  "예(Yes)" 클릭 — 수동으로 입력기를 설정하겠다는 뜻
• 3
  목록에서 fcitx5 선택
• 4
  "확인(OK)" 클릭 후 창 닫기

주의

설정이 끝난 후 반드시 재부팅해야 적용됩니다. reboot 명령어 또는 메뉴에서 재시작하세요.

03

한글 입력 모듈 추가

재부팅 후 우측 상단 트레이에 fcitx5 아이콘이 생겼는지 확인하세요. 아이콘이 보이면 정상 실행 중입니다.

트레이 아이콘을 우클릭 → Configure 클릭 후 설정 창에서 진행합니다.

• 1
  왼쪽 하단 [+] 버튼 클릭
• 2
  검색창에 "hangul" 입력
• 3
  Hangul 선택 후 추가
• 4
  Apply 후 창 닫기

04

한영 전환 키 설정

기본 한영 전환 키는

Shift

+

Space

입니다. 윈도우에 익숙한 분은 다른 키로 바꾸는 게 편해요.

설정 창에서 Hangul을 선택한 상태로 [설정] 버튼을 클릭하면 전환 키를 바꿀 수 있습니다.

크롬북 키보드에는 한/영 키가 따로 없어요. 오른쪽 Alt를

Hangul

키로 인식하도록 설정하면 자연스럽게 쓸 수 있습니다. 저도 이렇게 쓰고 있어요.

05

자동 시작 등록

재부팅 후 fcitx5가 자동으로 실행되지 않는 경우가 있어요. 아래 명령어로 자동 시작에 등록해 두세요.

cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart/

GUI로 하고 싶다면 설정 → 세션과 시작 프로그램 → 자동 시작 탭 → 추가 → fcitx5 입력해도 됩니다.

🩹 자주 나오는 오류와 해결법

⚠️ 재부팅해도 한글이 안 될 때

환경 변수가 제대로 설정되지 않은 경우입니다. 아래 내용을 ~/.profile 파일에 추가해 주세요.

export GTK_IM_MODULE=fcitx export QT_IM_MODULE=fcitx export XMODIFIERS=@im=fcitx

텍스트 에디터로 ~/.profile을 열어 붙여넣은 뒤 저장하고 재부팅하면 적용됩니다.

⚠️ fcitx5 아이콘이 트레이에 안 보일 때

fcitx5가 실행됐지만 트레이에 아이콘이 표시되지 않는 경우예요. 터미널에서 직접 실행해 보세요.

fcitx5 &

그래도 안 된다면 fcitx5를 완전히 재시작합니다.

fcitx5 -r

⚠️ VS Code에서 한글 입력이 안 될 때

fcitx5 설정을 마쳤어도 VS Code에서만 한글 입력이 안 되는 경우가 있어요. 아래 옵션을 추가해서 실행해 보세요.

code --enable-features=UseOzonePlatform --ozone-platform=x11

매번 이렇게 실행하기 번거롭다면, VS Code 바로가기 파일의 Exec= 줄에 위 옵션을 추가해두면 됩니다.

🌿 ibus-hangul로 설치하고 싶다면

fcitx5 대신 ibus-hangul을 쓰고 싶은 분을 위해 간단히 정리합니다.

sudo apt install ibus ibus-hangul ibus-setup

설정 창에서 입력 메서드 탭 → 추가 → 한국어 → Korean (Hangul) 순서로 추가하면 됩니다. im-config에서 ibus를 기본 입력기로 지정하는 과정은 fcitx5와 동일해요.

참고

ibus-hangul이 fcitx5보다 설치는 간단하지만, 일부 앱에서 입력이 튀거나 불안정한 경우가 있어요. 문제가 생기면 fcitx5로 전환하는 걸 추천합니다.

📋 설정 순서 한눈에 보기

#	단계	명령어 / 방법
01	fcitx5 설치	sudo apt install fcitx5 fcitx5-hangul fcitx5-config-qt
02	기본 입력기 변경	im-config → fcitx5 선택 → 재부팅
03	한글 모듈 추가	fcitx5 설정 → [+] → Hangul 추가
04	한영 전환 키 설정	Hangul 설정 → 원하는 키 지정
05	자동 시작 등록	cp org.fcitx.Fcitx5.desktop ~/.config/autostart/

처음 한 번만 제대로 설정해두면 이후로는 문제없이 씁니다. 설치 도중 막히는 부분이 있으면 댓글로 남겨주세요.

🔩

1편 — 설치 후기

크롬북 리눅스 설치 완전 정복 — WP나사 찾기부터 Xubuntu 부팅까지

›

📦

4편 — 필수 앱

Xubuntu 설치 후 제일 먼저 깔아야 할 앱 10개 — 크롬북 리눅스 실사용 추천

›

설정하다 막힌 부분이 있으면 댓글로 남겨주세요 😊

오류 증상을 알려주시면 아는 범위 내에서 같이 해결해 볼게요.

다음 글: Xubuntu 초기 설정 10가지 →

참고: fcitx5 공식 문서 / Ubuntu 공식 도움말