Linux下Minecraft无法使用Fcitx5中文输入法的问题

我很喜欢玩Minecraft,但在Linux下却常会遇到一些恼人的问题

问题描述

我的系统信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
fastfetch 

-` OS Arch Linux x86_64
.o+` ├  KER Linux 7.0.5-arch1-1
`ooo/ ├  PAK 1258
`+oooo: └  USR wilbur@archlinux-niri
`+oooooo:
-+oooooo+:
`/:-:++oooo+: WM niri 26.04 (Wayland)
`/++++/+++++++: ├  SHE fish 4.7.1
`/++++++++++++++: ├  TER kitty 0.46.2
`/+++ooooooooooooo/` └  TFO JetBrainsMapleMono-Regu)
./ooosssso++osssssso+`
.oossssso-````/ossssss+`
-osssssso. :ssssssso. PC 103C_5335M7 HP OMEN
:osssssss/ osssso+++. ├  CPU 13th Gen Intel(R) Core(z
/ossssssss/ +ssssooo/- ├  MEM 3.13 GiB / 15.31 GiB (2)
`/ossssso+/:- -:/+osssso+- ├ 󰢮 GPU NVIDIA GeForce RTX 4050e
`+sso+:-` `.-/+oso: ├  MON LGD076D 1920x1080@165
`++:. `-/+/ └ 󰋊 DIS 113.03 GiB / 380.90 GiBs
.` `/ └ 󰋊 DIS 408.38 GiB / 531.51 GiB3

Linux中运行的Minecraft,无法在任何“文本输入框/聊天框”中使用Fcitx5中文输入法输入中文
(中文、日文、韩文等,这应该是一样的问题)

在终端中运行fcitx5-diagnose命令,输出的信息中的DBus 界面信息中会显示

1
Group [x11::0] has 0 InputContext(s)

通过查阅Archwiki可知,Wayland上的Minecraft无法使用中文输入法

Wayland 上的 Minecraft 可能无法使用输入法,若要使用输入法,建议使用 Xwayland。

解决方案

在启动器(如HMCL)中打开高级设置,添加环境变量GTK_IM_MODULE=fcitx XMODIFIERS=@im=fcitx即可在Minecrft中正常使用中文输入法

如果不放心可以把参数加全(启动器中用就把export去掉)

1
2
3
4
5
6
7
8
9
10
#Java/X11
export _JAVA_AWT_WM_NONREPARENTING=1
export GLFW_PLATFORM=x11
export GDK_BACKEND=x11
export SDL_VIDEODRIVER=x11

#Fcitx5
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx

成功的标志:

  • 尝试在Minecraft任意文本框中使用输入法
  • 在运行Minecraft时再次运行fcitx5-diagnose命令,在输出的DBus 界面信息中有显示
    1
    2
    Group [x11::0] has 1 InputContext(s)
    IC [98f7d937f95f4767832b6cfdbd204a4a] program: frontend:xim cap:4000000000 focus:0

一些疑问

  • 在我的.config/niri/config.kdlenvironment中,明明有XMODIFIERS "@im=fcitx"却不管用(注:可以把GTK_IM_MODULE=fcitx移动到这里,全局生效)
  • 我不清楚java与Fcitx5之间是什么关系,不明白具体原理,同为java软件的STM32cubeMX就可以直接使用Fcitx5中文输入法(前提是以x11启动)

查阅过的信息

  • Archwiki
  • Arch论坛

在查资料的过程中,我看到了各种各样的关于输入法的问题,也看到了各种各样的解决方案

在一些特定版本的MC中,有一些游戏内输入法mod

有一些使用脚本来输入文本的先例

精力有限,不再列出


Linux下Minecraft无法使用Fcitx5中文输入法的问题
http://example.com/2026/05/14/Linux下Minecraft无法使用Fcitx5中文输入法的问题/
作者
Wilbur
发布于
2026年5月14日
许可协议