Configure (Ubuntu)

2025-10-03T21:52:54Z

Hosiet: Remove outdated files, redirect to Setup Fcitx 5

#REDIRECT [[Setup Fcitx 5]]

Install (Ubuntu)

2025-10-03T21:52:07Z

Hosiet: Delete outdated ubuntu-ppa setup; redirect to fcitx 5 install

#REDIRECT [[Install Fcitx 5]]

FAQ/zh-hans

2016-10-30T02:31:29Z

Hosiet:

<languages/>

当你抱怨输入法无法正常工作前，请先阅读这个页面。

从 4.2.7 开始，Fcitx 提供了一个 fcitx-diagnose 的命令，它可以检测一些常见的问题并且给出一些建议。

[[Special:MyLanguage/Hall of Shame for Linux IME Support|Linux 输入法支持耻辱堂]]

== 使用 Ctrl + Space 时无法激活 Fcitx ==

检查你所输入的程序。

=== 这是唯一一个有问题的程序吗？ ===
** 最可能的原因是某个快捷键占用了 Ctrl Space，请修改另一个快捷键并重试。这常见于编辑器中，因为很多集成开发环境默认使用 Ctrl+Space 作为补全的快捷键。

=== 所有 Gtk 程序都有问题？ ===
* 请打开一个传统意义上的Gtk程序（所谓传统，就是它不应该是Firefox，Libreoffice这种仅仅是是使用Gtk样式作为界面的程序）。Gedit是一个不错的选择。右键点击输入框，将会弹出一个“输入法”菜单，请确认“Fcitx”被选中。

* 如果菜单中确实有Fcitx，但是还是无法正常工作，请先尝试重新启动Fcitx，如果这次就可以工作了，那么请检查你的DBus设置，或者延长Fcitx的启动时间。如果你使用自定义的启动脚本，你可以参考[[Special:MyLanguage/Configure (Other)|配置 (其他)]]

* 如果Fcitx没有默认选中，那么请先尝试选中它，并且立刻试试可否输入。如果不行，请参见上面一条。为了永久性的修复这个问题（默认选中 Fcitx ），请阅读[[Special:MyLanguage/Install and Configure|安装和配置]]中的配置部分。

* 如果没有 Fcitx这项，那么请首先检查你的安装，你所需要的包名包含了fcitx和gtk。如果你是[[Special:MyLanguage/Compile from source|从源码编译的Fcitx]]，请确认你启用了GTK2，GTK3的输入法模块选项。如果你确认这点的话，请阅读[[Special:MyLanguage/Input method related environment variables|输入法相关的环境变量]]中的如何更新Gtk的缓存文件。

* 如果你正在使用 Ubuntu，并且刚刚升级到 12.04，或者发生了什么不好的事情 (由于打包者的疏忽，或者有问题的包管理器无法按照正确顺序更新包，例如 pacman) 你可能会注意到 gtk.immodules 相关的文件并未在升级时正确生成。试试卸载{{package ubuntu|fcitx-frontend-gtk2}}, {{package ubuntu|fcitx-frontend-gtk3}} 或者你发行版对应的包，然后重新安装这两个包来触发文件的生成。然后重新检查输入法菜单里面是否有“Fcitx”。

=== 所有Qt程序都有问题？ ===
* 运行qtconfig (名称可能根据你的发行版有所不同，他可能是 qtconfig-qt4 )，选择第三个标签，确认fcitx是在默认输入法组合框中。如果没有，请检查你的安装。
* 以上解决方案也可以类似解决XIM的问题，但我们强烈建议你使用输入法模块。参见 [[Special:MyLanguage/Input method related environment variables|输入法相关环境变量]]。

=== 出问题是 Java，Xterm, wine 或者其他的非 Gtk/Qt 程序吗？ ===
在一些少见的情况，你可能在使用嵌入式Linux或者小型Linux发行版，而你必须使用XIM，X server可能缺少一些 locale 文件，这些文件通常需要被放在 /usr/share/X11/locale/ 下。

并且当你必须使用 XIM 的时候，请确认你的 locale '''不能'''被设置为 C 或者 POSIX，并且需要被设置为一个可用的 locale （语言无所谓），并且如果你使用的是 glibc，你需要生成对应的locale的文件(locale-gen)。当你使用 im module 的时候，并无这个限制。

=== Emacs ===
试试

LC_CTYPE=zh_CN.UTF-8 emacs

别忘记检查你的 locale -a 确实包含了locale，参见 [[Special:MyLanguage/Input method related environment variables|输入法相关环境变量]]。

Emacs 使用 `-*-*-*-r-normal--14-*-*-*-*-*-*-*' 作为默认自己 (于 src/xfns.c)，如果你没有匹配的字体 (例如 terminus、75dpi，可以用 xlsfonts 查看)，将无法使用 XIM。

== Firefox 中的 Google Docs 有问题 ==

你也许想暂时关掉预编辑文本，默认快捷键为Ctrl+Alt+P。

== 无法在 Flash 中使用 Fcitx ==

请阅读 [[Special:MyLanguage/Hall of Shame for Linux IME Support|Linux输入法支持耻辱堂]]，并使用输入法模块。

== 更新至新于 4.2.4 的版本之后，无法输入英文 ==

请确认你将“[[Special:myLanguage/Keyboard|键盘]]”加入了输入法列表。你可以使用[[Special:myLanguage/Integrate with Desktop#Configuration tool|配置工具]]来修改和查看。

并且你可能希望将“键盘”移至第一项。

== 非预期的键盘布局变化 ==

用[[Special:myLanguage/Integrate with Desktop#Configuration tool|配置工具]]来为特定的输入法绑定特定的键盘布局。

== xmodmap 的设置被覆盖 ==

Fcitx 现在可以控制键盘布局，并且在键盘布局切换时，xmodmap的设置将被覆盖。因此 fcitx-xkb 提供了一个选项来指定xmodmap脚本的位置，并且可以让fcitx来在键盘布局变化时加载这个配置。直接禁用 fcitx-xkb 也是一种选择，或者如果您的需求很简单，例如只是想交换 Caps Lock 和 Esc 的位置，部分选项可以由xkb选项来提供，您可以通过您桌面的键盘配置工具来设置这些选项 (Gnome 和 KDE 都支持这类配置)。

选项具体的细节解释如下，xmodmap是一个非常底层的工具，并不了解键盘布局的设置，对X11来说，键盘布局是建立在一组预设文件上，当预设文件加载时，所有通过xmodmap加载的配置都将被覆盖，这并不是只针对fcitx而言如此，所有进行键盘布局设置的工具都是如此。Xkb 选项是一组可以按照预定义设置来修改键盘布局的选项，涵盖了绝大多数一般人想用xmodmap进行的设置，例如死键的位置，交换 Caps Lock 和 Esc 等等。除非您有特殊需求，推荐使用 xkb 布局和 xkb 选项。

自 4.2.7 起，如果 ~/.Xmodmap 存在，Fcitx 将会尝试自动加载。

== 配置用户界面，字体，纵向列表 ==

使用[[Special:myLanguage/Integrate with Desktop#Configuration tool|配置工具]]，附加组件配置 -> 经典界面。

如果您使用的 [[Special:myLanguage/Configtool|Gtk 配置工具]] 新于 0.4.5，或者 [[Special:myLanguage/Kcm|Kcm]] 新于 0.4.1，您可以直接在顶层标签配置界面。

== GNOME 3.6 可能的问题 ==

[[Note for GNOME Later than 3.6]]

== [[Special:MyLanguage/ClassicUI|经典界面]]不透明 ==

* 这个问题已经通过用不同的方式检测混成管理器而不在 4.2.6 之后的版本中存在了。请先重启 Fcitx，如果这时没问题了，那么可能是你的窗口管理器的Bug。Gnome-Shell，xcompmgr 已知存在这样的Bug。你可以尝试延迟启动来绕过这个问题。
* 如果重启Fcitx没有解决这个问题，请检查你的窗口管理器是否支持混成，以及是否启用了混成。
=== Kwin ===

启用桌面特效。

=== Metacity before GNOME3 ===

gconftool-2 -s --type bool /apps/metacity/general/compositing_manager true
=== Xfce ===

支持混成，但需要手动启用。
=== Compiz ===

0.9 系列可以禁用混成，你可以用ccsm来配置。
=== 其他窗口管理器 ===

你可以用 xcompmgr， cairo-compmgr 来作为混成管理器。

== Minecraft ==

原版 Minecraft 在 Linux 下不支持输入，更糟的是，XIM 还和它的按键事件处理冲突，一个绕过的办法是，故意设置一个错误的环境变量然后启动它。你可以使用下面的脚本：

<pre>#!/bin/sh
# set a wrong one
export XMODIFIERS="@im=null"
# start minecraft, this might change depends on you're mod, but simply its what you ARE using to start minecraft.
java -Xmx1024M -Xms512M -cp minecraft.jar net.minecraft.LauncherFrame</pre>

这个方法也可以不想在一些 XIM 的程序下面用 fcitx 的时候使用。

有一个名为 [http://forum.minecraftuser.jp/viewtopic.php?t=6279 NihongoMOD] 的 mod 可以在 Linux 下支持输入，1.2.2 和 minecraft 1.5.2 测试和 Fcitx 不需要 hack 就可以输入。

== 在一般用户的 X 下运行 Root 权限的程序 ==
以 Root 运行的程序在一般用户的 X 会话下总是有问题的（一般意义上，并不只针对 fcitx），这是因为 dbus 是一个仅限用户会话的进程。唯一在root程序中的办法使用 fcitx 的办法是通过 XIM，需要启动程序前设置 GTK_IM_MODULE=xim 和 QT_IM_MODULE=xim。

= 光标跟随问题 =
一个常见的误解是由于输入法的问题导致无法光标跟随，但这是错的。光标跟随的原理是：程序将光标位置发送给输入法，输入法移动输入框。因此如果程序不发送位置的话，位置就会是错误的。这个行为是由程序控制的，而不是输入法。因此当你遇见任何问题的时候，请要求程序来修复这个问题，不要要求输入法做任何事。实际上，输入法做不了任何额外的事情。

尽管可能存在一些能够绕过特定问题的办法，但是bug还是在程序而不是输入法中。

* Opera，在 [[Special:MyLanguage/XIM|XIM]] 中启用 on the spot 。
* Firefox，启用预编辑文本。

[[Category:How-to]]

Translations:FAQ/13/zh-hans

2016-10-30T02:31:29Z

Hosiet:

= 光标跟随问题 =
一个常见的误解是由于输入法的问题导致无法光标跟随，但这是错的。光标跟随的原理是：程序将光标位置发送给输入法，输入法移动输入框。因此如果程序不发送位置的话，位置就会是错误的。这个行为是由程序控制的，而不是输入法。因此当你遇见任何问题的时候，请要求程序来修复这个问题，不要要求输入法做任何事。实际上，输入法做不了任何额外的事情。

Fcitx/zh-hans

2016-08-25T00:09:31Z

Hosiet:

<languages/>

{{infobox|image1=[[File:Fcitx-Keyboard.png]]|caption=[[Special:myLanguage/Keyboard|Fcitx 键盘]]和 [[Special:myLanguage/Kimpanel|Kimpanel]]}} {{infobox|image1=[[File:Fcitx-pinyin.png]]|caption=[[Special:myLanguage/Built-in Pinyin|拼音]]和[[Special:myLanguage/ClassicUI|经典界面]]}}

Fcitx [ˈfaɪtɪks] 是一个支持扩展的输入法框架。当前它支持 Linux 和 Unix 系统，例如 freebsd。它包括了三个内置的输入法引擎，[[Special:myLanguage/Built-in Pinyin|拼音]]，[[Special:myLanguage/QuWei|区位]]和基于[[Special:myLanguage/Table|码表]]的输入法。

Fcitx 尝试提供在所有桌面环境下原生的体验，并保持其内核轻量。你可以很简单的将其按照你的需要进行配置。

== 向导 ==

* [[Special:myLanguage/Install and Configure|安装和配置]]
* [[Special:myLanguage/Install input method|安装输入法]]
* [[Special:myLanguage/Use Fcitx's Addon|使用Fcitx的附加组件]]
* [[Special:myLanguage/Integrate with Desktop|与桌面集成]]
* [[Special:myLanguage/Compile from source|从源码编译]]
* [[Special:myLanguage/FAQ|常见问题]]
* [http://download.fcitx-im.org/ 下载源代码]

== 帮助 Fcitx ==
* 将 Fcitx 告诉你的朋友
* [[Special:myLanguage/Report Bug|汇报错误]]
* [[Special:myLanguage/Contribute to this Wiki|撰写本 Wiki]] ('''请在请求账号前阅读此内容''')
* [[Special:myLanguage/Become a developer|成为开发者]]
* [[Special:myLanguage/Build source code mirror|建立源代码镜像]]
* [[Distribution Package Status|为你的发行版打包 Fcitx]]
* [[Special:myLanguage/Donate|捐赠]]

== 关于 Fcitx ==
* [[Special:myLanguage/History|历史]]

Translations:Fcitx/5/zh-hans

2016-08-25T00:09:31Z

Hosiet:

== 帮助 Fcitx ==
* 将 Fcitx 告诉你的朋友
* [[Special:myLanguage/Report Bug|汇报错误]]
* [[Special:myLanguage/Contribute to this Wiki|撰写本 Wiki]] ('''请在请求账号前阅读此内容''')
* [[Special:myLanguage/Become a developer|成为开发者]]
* [[Special:myLanguage/Build source code mirror|建立源代码镜像]]
* [[Distribution Package Status|为你的发行版打包 Fcitx]]
* [[Special:myLanguage/Donate|捐赠]]

Fcitx - User contributions [en]

Configure (Ubuntu)

Install (Ubuntu)

FAQ/zh-hans

Translations:FAQ/13/zh-hans

Fcitx/zh-hans

Translations:Fcitx/5/zh-hans