# Debian / Ubuntu / Q4OS (基于 Debian 系)安装拼音输入法

要在 Fcitx 输入法框架中添加中文拼音输入，通常有两种情况：一种是刚刚安装好 Fcitx 框架但还没有拼音引擎，另一种是已经安装了拼音引擎但需要手动添加。

请根据你的实际情况，按照以下步骤操作：

### 第一步：确认已安装拼音引擎（关键）

很多时候无法添加中文输入，是因为只安装了 Fcitx 框架（外壳），而没有安装具体的拼音输入法软件（引擎）。

你需要先打开终端（Konsole），根据你的 Linux 发行版执行安装命令：

- **Debian / Ubuntu / Q4OS (基于 Debian 系):**
    
    ```bash
    sudo apt update
    sudo apt install fcitx-pinyin fcitx-table-wubi
    
    ```
    
    *(注：`fcitx-pinyin` 是最基础的拼音输入法，如果想要更智能的云词库，可以尝试安装 `fcitx-googlepinyin` 或 `fcitx-sunpinyin`)*
- **Arch Linux:**
    
    ```bash
    sudo pacman -S fcitx-im fcitx-configtool fcitx-pinyin
    
    ```
- **Fedora:**
    
    ```bash
    sudo dnf install fcitx fcitx-pinyin
    
    ```

**安装完成后，请务必重启 Fcitx 或重启电脑**，让新安装的输入法生效。

### 第二步：通过配置界面添加拼音

安装好引擎后，你需要将其添加到激活列表中：

1. **打开配置工具**：
    
    
    - 在开始菜单中搜索“Fcitx 配置”或“Fcitx Configuration”。
    - 或者在系统托盘（屏幕右下角）找到 Fcitx 的键盘图标，右键点击选择“配置”。
2. **取消“仅显示当前语言”**：
    
    
    - 在配置窗口的下方，找到并**取消勾选**“仅显示当前语言”或“Only Show Current Language”选项。这一步非常重要，否则你可能看不到拼音输入法。
3. **添加输入法**：
    
    
    - 点击窗口下方的“+”号（添加）。
    - 在弹出的搜索框中输入“Pinyin”或“拼音”。
    - 你应该能看到“汉语 (Pinyin)”或“Fcitx Pinyin”的选项。
    - 选中它，点击“确定”或“添加”。
4. **调整顺序（可选）**：
    
    
    - 在“激活的输入法”列表中，你可以通过上下箭头调整输入法的顺序。通常建议把“键盘-英语”放在第一位，把“Pinyin”放在第二位，这样开机默认是英文，按切换键后才是中文。

### 第三步：检查环境变量（如果上述步骤无效）

如果安装了也添加了，但在任何软件里都调不出来，可能是环境变量没配对。

请检查你的 `~/.xprofile` 或 `~/.bashrc` 文件（取决于你的系统启动方式），确保包含以下内容：

```bash
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS="@im=fcitx"

```

添加后，注销并重新登录系统即可生效。

**总结：** 绝大多数情况下，你只需要执行 **`sudo apt install fcitx-pinyin`**（针对 Debian/Ubuntu 系），然后重启电脑，系统就会自动识别并允许你添加中文拼音了。