# Ubuntu 中文输入法（Fcitx5 + Rime）安装与配置

> 环境：Ubuntu 22.04，GNOME + Wayland
> 方案：Fcitx5 + Rime（朙月拼音），默认输出简体中文

## 一、卸载 IBus（避免冲突）

Ubuntu 默认使用 IBus，建议彻底移除以防止干扰：

```bash
sudo apt remove ibus
killall ibus-daemon  # 确保进程终止
```

## 二、安装 Fcitx5 及 Rime 组件

```bash
sudo apt update
sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-rime fcitx5-module-cloudpinyin fcitx5-config-qt
```

各组件说明：

- `fcitx5-rime`：Rime 引擎支持
- `fcitx5-chinese-addons`：中文相关扩展
- `fcitx5-module-cloudpinyin`：可选，启用云拼音（新词联想）
- `fcitx5-config-qt`：图形化配置工具（即使在 GNOME 也能用）

## 三、配置环境变量

为了让所有应用（GTK/Qt）识别 Fcitx5，需配置环境变量：

```text
vim ~/.pam_environment
```

添加以下内容：

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

> 💡 注意：Ubuntu 22.04 使用 GNOME + Wayland，**必须使用 `.pam_environment`**，`.profile` 或 `.bashrc` 在某些场景下会失效。

## 四、重启或重新登录

注销当前用户并重新登录，使环境变量生效。

## 五、配置输出简体中文

刚安装完 Rime，默认可能输出**繁体字**（如「妳好」）。我们需要配置默认使用简体方案。

Rime 的配置文件位于：

```bash
~/.local/share/fcitx5/rime/
```

创建或编辑：

```bash
vim ~/.local/share/fcitx5/rime/default.custom.yaml
```

填入以下内容（关键！）：

```yaml
patch:
  # 把简体拼音放在第一个，默认就用它
  schema_list:
   - schema: luna_pinyin_simp  # 朙月拼音·简化字（简体）
   - schema: luna_pinyin       # 朙月拼音（繁体，保留备用）
   # 你其他的方案，比如五笔、双拼等
```

> ⚠️ 重要提醒：
>
> - 通过 `schema_list` 设置输入方案列表，**放在第一个的方案即为默认方案**。
> - `luna_pinyin_simp` 是朙月拼音简化字版本，直接输出简体中文。

修改配置后，**必须执行 Deploy 才会生效**：

右键点击系统托盘中的 **Fcitx5 图标**（键盘或"中"字），选择 **"Deploy"**（部署），等待弹出"成功"提示。

> ✅ 部署成功后，输入 `nihao` 应显示 **「你好」**（简体）。

## 六、美化面板主题

默认面板较为朴素，可通过主题美化。

### 1. 安装 Material 主题

```bash
sudo apt install fcitx5-material-color
```

### 2. 配置主题与字体

打开 Fcitx5 配置工具：

```bash
fcitx5-config-qt
```

在图形界面中：

1. 点击左侧的 **"附加组件"**（Addons）
2. 找到 **"经典用户界面"**（Classic User Interface）
3. 点击右侧的 **"配置"** 按钮
4. 在弹出的窗口中设置：

- **主题**：选择 `Material-Blue`（或其他喜欢的主题）
- **字体**：设置为 `Noto Sans CJK SC 12`
- **垂直候选列表**：勾选（可选）

点击 **"应用"** 或 **"确定"** 保存设置。

> 其他可选主题：`Material-Red`、`Material-Green`、`Dark` 等。

重启 Fcitx5 或重新登录即可看到效果：圆角、阴影、彩色高亮，现代感十足。

### 3. 使用 GitHub 主题包（更丰富）

如果想要更接近 macOS 风格的主题，可以使用开源主题包：

- 仓库地址：<https://github.com/thep0y/fcitx5-themes-candlelight>

下载并安装：

```bash
git clone https://github.com/thep0y/fcitx5-themes-candlelight.git
cd fcitx5-themes-candlelight
./install.sh # 按照下面提示输入然后回车就能自动安装好
```

> 安装完成后，主题已经就绪，此时只需要执行一次 Deploy：
>
> - 右键点击系统托盘中的 **Fcitx5 图标**（键盘或"中"字）
> - 选择 **"Deploy"**（部署）
> - 等待弹出"成功"提示

> 💡 主题效果预览图来自知乎图床，未随笔记保留；实际效果以本地安装后为准。

## 七、常用技巧

- **切换中英文**：`Ctrl + Space`（可自定义）
- **切换简繁**：`F4`
- **翻页候选词**：`PageDown` / `+` 键
- **部署配置快捷方式**：右键 Fcitx5 图标 → Deploy