在樹莓派 5 (Raspberry Pi 5) 上安裝中文輸入法

---------------------------------------------------

恭喜入手樹莓派 5！這台小鋼炮效能強勁，跑中文輸入法自然是游刃有餘。

由於 Raspberry Pi 5 預設採用的是 Debian Bookworm 版本作業系統，並且使用了 Wayland 顯示伺服器，因此我強烈建議安裝最新的 Fcitx5 框架。它比起舊版的 Fcitx 4 更穩定、對 Wayland 的支援也更完美。

以下是在 Raspberry Pi 5 上安裝中文輸入法的最佳實踐步驟：

第一步：更新系統環境

在開始安裝任何軟體前，先確保系統清單是最新的。請打開終端機（Terminal）並輸入：

Bash

sudo apt update
sudo apt upgrade -y

第二步：安裝 Fcitx5 框架與輸入引擎

根據你的使用習慣，選擇安裝 注音 (Chewing) 或 拼音 (Pinyin)。

• 安裝 Fcitx5 主程式與常用引擎：

Bash

sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-chewing fcitx5-frontend-gtk3 fcitx5-frontend-qt5 -y

小提醒： fcitx5-chewing 是新酷音（注音），如果你習慣拼音，fcitx5-chinese-addons 裡面已經內含了 Pinyin 引擎。

第三步：設定預設輸入法

安裝完成後，我們需要告訴系統「請預設使用 Fcitx5」。

1. 在終端機輸入：

   Bash

    

   im-config -n fcitx5
   

2. 這會將系統的輸入法架構切換為 Fcitx5。

第四步：配置 Fcitx5 與啟動

1. 重啟系統： 為了確保設定生效，建議先重啟。

   Bash

    

   sudo reboot
   

2. 開啟設定介面： 重啟後，在右上角的系統圖示區應該會看到一個鍵盤圖示。點擊右鍵選擇 「設定 (Configure)」。

3. 加入輸入法： 在彈出的視窗中，點擊左下角的 「+」 號，搜尋 "Chewing" (新酷音/注音) 或 "Pinyin" 並將其加入右側清單。

4. 切換快捷鍵： 預設通常是 Ctrl + Space。

常見問題與小撇步

• 如果選單沒出現中文？

  請確保你在 raspi-config 中已經設定好語系（Localization Options -> Locale），建議至少包含 zh_TW.UTF-8 或 zh_CN.UTF-8。

• 介面美化：

  Fcitx5 支援佈景主題。如果你覺得預設介面太「工程師風」，可以安裝 fcitx5-material-color 來獲得更現代的外觀。

下一步建議：

你需要我幫你寫一個自動安裝並設定語系的自動化腳本嗎？或者你想了解如何在樹莓派上設定繁簡轉換？

----------請給我一個自動安裝並設定語系的自動化腳本----------

沒問題！這是一個為 Raspberry Pi 5 (Debian Bookworm) 量身打造的自動化腳本。

這個腳本會幫你完成：更新系統、產生繁體中文語系 (zh_TW)、安裝 Fcitx5 框架及其組件，並將系統預設輸入法切換為 Fcitx5。

🚀 樹莓派 5 中文環境自動化腳本

你可以將以下程式碼複製並儲存為 install_chinese.sh。

Bash

#!/bin/bash

# 檢查是否以 root 權限執行
if [ "$EUID" -ne 0 ]; then 
  echo "請使用 sudo 執行此腳本：sudo bash $0"
  exit
fi

echo "--- 🌟 開始安裝樹莓派中文環境 (Fcitx5) ---"

# 1. 更新系統清單
echo "🔄 正在更新套件清單..."
apt update && apt upgrade -y

# 2. 設定語系 (Locales)
echo "🌐 正在產生繁體中文語系 (zh_TW.UTF-8)..."
# 解除 zh_TW.UTF-8 的註解並產生
sed -i '/^#.*zh_TW.UTF-8 UTF-8/s/^#//' /etc/locale.gen
locale-gen

# 設定系統語系（這會讓介面變中文，若只想維持英文介面請註解掉下一行）
# localectl set-locale LANG=zh_TW.UTF-8

# 3. 安裝 Fcitx5 框架與新酷音 (注音)
echo "📦 正在安裝 Fcitx5 與相關套件..."
apt install -y fcitx5 fcitx5-chinese-addons fcitx5-chewing fcitx5-frontend-gtk3 fcitx5-frontend-qt5 fcitx5-config-qt fonts-wqy-microhei fonts-wqy-zenhei

# 4. 設定輸入法框架為 Fcitx5
echo "🔧 設定系統預設輸入法為 Fcitx5..."
# 使用 im-config 針對目前的 user 進行設定 (腳本內需指定 user)
CURRENT_USER=$(logname)
sudo -u $CURRENT_USER im-config -n fcitx5

# 5. 完成
echo "------------------------------------------------"
echo "✅ 安裝完成！"
echo "💡 提示：請重新開機以啟用變更。"
echo "💡 開機後，請在右上角 Fcitx5 圖示點右鍵 -> '設定' -> 加入 'Chewing' (新酷音)。"
echo "------------------------------------------------"

# 詢問是否立即重啟
read -p "是否要現在重新開機？(y/n) " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
    reboot
fi

如何執行這個腳本？

1. 建立檔案：

   在終端機輸入 nano install_chinese.sh，然後把上面的程式碼貼上去。

2. 儲存並退出：

   按下 Ctrl + O 儲存，再按 Enter 確認，最後按 Ctrl + X 離開。

3. 賦予執行權限：

   Bash

    

   chmod +x install_chinese.sh
   

4. 執行腳本：

   Bash

    

   sudo ./install_chinese.sh
   

補充小知識

• 字體優化： 腳本中我額外幫你安裝了 fonts-wqy-microhei（文泉驛微米黑），這會讓中文字在螢幕上看起來更清晰，不會有破碎感。

• 拼音用戶： 如果你其實是想用拼音而非注音，腳本安裝完後，直接在 Fcitx5 設定裡搜尋 Pinyin 加入即可，不需要額外安裝套件。

下一步建議：

重啟後，如果在使用上遇到快捷鍵衝突（例如想把切換鍵改為 Shift），需要我教你如何進階設定 Fcitx5 的熱鍵嗎？

----------如何進階設定 Fcitx5 的熱鍵----------------

既然環境都跑起來了，我們來把 Fcitx5 調教得更順手。在 Raspberry Pi 5 上，進階設定主要分為「全域快捷鍵」（切換輸入法）和「內建行為」（例如按一下 Shift 切換中英文）。

以下是進階設定的攻略：

1. 開啟設定介面

你可以透過以下兩種方式進入設定：

• 圖形介面： 在工作列右上角的鍵盤（或「華」/「拼」）圖示上按 右鍵 -> 點選 「設定 (Configure)」。

• 終端機指令： 直接輸入 fcitx5-config-qt 並按回車。

2. 修改全域切換快捷鍵（Global Options）

如果你不習慣預設的 Ctrl + Space，想改成類似 Windows 的 Win + Space 或 Ctrl + Shift：

1. 點擊上方標籤頁的 「全域選項 (Global Options)」。

2. 找到 「切換輸入法 (Trigger Input Method)」。

3. 點擊右側的按鈕，然後直接按下你想要的組合鍵（例如 Ctrl + Shift）。

4. 專業建議： 建議保留兩個快捷鍵，一個設為 Ctrl + Space，另一個設為你習慣的組合。

3. 設定「單鍵」切換中英文（最推薦！）

這是在台灣/香港使用中文輸入法最關鍵的設定——按一下 Shift 就切換中英文。

1. 同樣在 「全域選項 (Global Options)」 標籤頁中。

2. 找到 「切換輸入法之額外快捷鍵 (Extra key for triggering input method)」。

3. 下拉選單選擇 「Shift」（或是你喜歡的 Caps Lock、Control）。

4. 行為設定： 建議將其設為 「按下時 (Both)」，這樣你輕敲一下 Shift 就會在中/英之間跳轉。

4. 針對「新酷音 (Chewing)」的進階調整

如果你是用注音，可以針對輸入習慣做更細膩的設定：

1. 回到 「輸入法 (Input Method)」 標籤頁。

2. 選中 「Chewing (新酷音)」，點擊右側的 「齒輪（配置）」 圖示。

3. 選字設定： 你可以調整「候選字個數」（預設通常是 10 個，改為 9 個更符合鍵盤排列）。

4. 鍵盤排列： 如果你是用「大千」、「許氏」或「倚天」，可以在這裡切換設定。

5. 配置文件路徑（硬核玩家專用）

如果你偏好直接修改設定檔（或者想備份設定），Fcitx5 的所有設定都存在這裡：

• 全域設定： ~/.config/fcitx5/config

• 輸入法清單： ~/.config/fcitx5/profile

你可以用 nano 開啟它們：

Bash

nano ~/.config/fcitx5/config

💡 小提醒：Wayland 的限制

Raspberry Pi 5 預設使用 Wayland 顯示協議。有時候系統層級的快捷鍵（例如 Super + Space）可能會被桌面環境先攔截掉。如果你發現設定了沒反應，可以嘗試換一組較不常用的組合鍵，或者進入系統的 「鍵盤設定」 檢查是否有衝突。

下一步建議：

你的 Fcitx5 現在應該很順手了！需要我順便教你如何更換輸入法的外觀（Skin/Theme），讓它看起來跟 macOS 或 Windows 11 一樣精美嗎？