Ubuntu Qt Creator 無法輸入中文？Fcitx5 + Sogou 輸入法完整配置指南

Qt Creator 在 Ubuntu 下預設使用 IBus 輸入法架構，但許多中文輸入法 (如搜狗、Rime) 僅支援 Fcitx5，導致編輯器無法啟用中文輸入。本文提供標準化配置流程：安裝 Fcitx5、設定環境變數、配置 Qt 插件、驗證生效。

一、安裝 Fcitx5 與搜狗輸入法

# 1. 安裝 Fcitx5 核心與 GTK/Qt 模組
sudo apt update
sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-frontend-gtk3 fcitx5-frontend-qt5 fcitx5-config-qt

# 2. 安裝搜狗輸入法 (下載 .deb)
# 官網: https://pinyin.sogou.com/linux/
# 假設下載為 sogoupinyin_4.2.0.XXXX_amd64.deb
sudo apt install ./sogoupinyin_*.deb
# 若缺依賴
sudo apt install -f

二、設定輸入法架構為 Fcitx5

# 圖形化介面 (推薦)
im-config
# 選擇 "fcitx5" → OK → 重新登入

# 或手動設定環境變數 (見下節)

三、配置環境變數 (關鍵步驟)

編輯 ~/.profile (或 ~/.xprofile、~/.pam_environment)，**在檔案末尾添加**：

# Fcitx5 環境變數
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
export SDL_IM_MODULE=fcitx
export GLFW_IM_MODULE=fcitx

# 語系設定 (確保中文顯示正常)
export LANG=zh_TW.UTF-8
export LC_CTYPE=zh_TW.UTF-8

注意：
1. 勿同時設定 IBus 變數 (如 QT_IM_MODULE=ibus)，會衝突。
2. ~/.profile 於圖形登入時由 Display Manager 讀取，適用大多數桌面環境 (GNOME、KDE、Xfce)。
3. Wayland 會話下可能需額外設定 QT_QPA_PLATFORM=wayland 並確保 fcitx5-wayland 已安裝。

四、安裝 Qt Fcitx5 平台插件 (Qt 5/6 通用)

sudo apt install fcitx5-frontend-qt5 fcitx5-frontend-qt6

此插件讓 Qt 應用 (含 Qt Creator) 能正確載入 Fcitx5 輸入法模組。

五、重新登入驗證

1. 登出並重新登入 (或重啟)。
2. 開啟 Fcitx 5 設定 (應用程式選單搜尋)，在「輸入法」頁籤添加「搜狗拼音」或「Rime」。
3. 啟動 Qt Creator，在編輯器按 Ctrl+Space (或配置的觸發鍵) 切換輸入法，應可正常輸入中文。

六、常見問題排查

七、進階：使用 Rime (中州韻) 替代搜狗

Rime 為開源跨平台輸入法引擎，支援注音、倉頡、拼音等多種方案，配置檔為純文字，極度穩定：

sudo apt install fcitx5-rime
# 設定 → 輸入法 → 添加 "Rime" → 重新部署 (工具列圖示右鍵 → 重新部署)
# 方案選擇: 朙月拼音、倉頡、注音等

核心心法：「架構統一用 Fcitx5，環境變數四大件 (GTK/QT/XMODIFIERS/SDL) 缺一不可，Qt 插件必裝，重新登入才生效」。