fcitx5-themes-candlelight（烛光）是专为 fcitx5 输入法打造的一套免费、简约风格的 fcitx5 皮肤合集，内置 8 款现成主题：春日绿、夏日红、秋日橙、冬日蓝、荧光绿、透明荧光绿，以及两款仿 macOS 的亮色/暗色主题。项目自带install.sh一键安装脚本，新手也能在 1 分钟内完成 fcitx5 皮肤的下载、安装与配置，无需手动编辑任何配置文件。

为什么选择 fcitx5-themes-candlelight 皮肤 🎨

这套 fcitx5 输入法皮肤把 8 款主题整理成了 3 个系列，风格区分清晰：

fcitx5皮肤macOS-light主题预览效果

相比「手动复制主题目录 + 逐个编辑配置文件」的传统做法，本项目最大的亮点是 install.sh 一键安装脚本：

1. 自动创建主题目录~/.local/share/fcitx5/themes与配置目录~/.config/fcitx5/conf
2. 下载最新 fcitx5 皮肤资源，并把选中的主题复制到目标目录
3. 一次性写好classicui.conf关键配置（横排候选列表、按屏 DPI、字体、主题名）
4. 可选开启 fcitx5-rime 单行模式，最后自动重启 fcitx5 让皮肤立即生效

install.sh 一键安装 fcitx5 皮肤步骤

第 1 步：克隆项目获取安装脚本

git clone https://gitcode.com/gh_mirrors/fc/fcitx5-themes-candlelight

第 2 步：运行 install.sh 并按提示操作

cd fcitx5-themes-candlelight sh install.sh

整个安装过程只有3 个交互提问，跟着提示输入即可：

提问 1：是否从 GitHub 下载/更新主题？

• 输入y：自动通过镜像下载最新 fcitx5 皮肤并更新全部 8 款主题（网络不佳时脚本默认走 ghproxy.net 加速镜像）
• 输入N（默认）：直接使用已克隆到本地的主题，适合已下载过或离线环境

提问 2：输入主题编号（1~8）

提问 3：是否配置单行模式？

• 使用 fcitx5-rime 且希望预编辑文字直接显示在应用内时输入y，脚本会向rime.conf写入PreeditInApplication=True
• 不需要则保持默认N

安装结束时脚本会自动执行fcitx5 -r重启输入法，皮肤即刻生效，无需任何额外操作（见 install.sh）。

install.sh 自动帮你做了什么 ⚙️

脚本替你完成了原本需要手动编辑的 3 处配置，核心是~/.config/fcitx5/conf/classicui.conf（写入逻辑见 install.sh）：

Vertical Candidate List=False # 候选列表横向排列 PerScreenDPI=True # 按屏幕 DPI 缩放 Font="思源黑体 13" # 候选区字体 Theme=spring # 主题名，即你选择的编号

另外两点小提示：

• 安装后想换主题：直接修改classicui.conf中的Theme=行再重启 fcitx5 即可
• 在 fcitx5-rime 中按<Ctrl>+<Alt>+P可在单行/双行（预编辑）模式间快速切换

常见问题：fcitx5 皮肤安装 FAQ

Q：macOS 系列皮肤显示异常、方框或透明失效？

部分桌面环境不支持渲染 SVG，导致仿 macOS 主题显示异常。建议优先使用 SVG 版（如 macOS-light/panel.svg）；若出现异常，把classicui.conf中Theme=改为同名-png版（macOS-light-png/macOS-dark-png）即可，效果完全一致。

Q：字体不是我想要的怎么办？

脚本默认写入思源黑体 13，打开~/.config/fcitx5/conf/classicui.conf修改Font=一行，再执行fcitx5 -r重启生效。

Q：安装完找不到皮肤？

确认~/.local/share/fcitx5/themes下存在对应主题目录，且Theme=拼写与目录名完全一致（区分大小写），然后重启 fcitx5。

总结

fcitx5皮肤macOS-dark暗色主题预览

fcitx5-themes-candlelight用一份 install.sh 把 fcitx5 皮肤安装简化成了「克隆 → 运行脚本 → 输入 3 个选项」三步：8 款简约主题任选，配置、重启全部自动化，是新手美化 fcitx5 输入法输入体验的最快路径。更多主题细节可参考项目 README.md，各主题的完整配置项（如 spring/theme.conf、macOS-dark/theme.conf）也都可以按喜好自行微调。