Ubuntu 24.04下Qt Creator无法输入中文？fcitx5配置与排查指南

1. 问题剖析：为什么Qt Creator在Ubuntu 24.04下打不出中文

先说结论：这未必是输入法本身的问题，多半是Qt Creator这个程序根本没有“接入”你的输入法框架。

Ubuntu 24.04默认用的是GNOME桌面，系统自带的输入法框架是IBus。但很多从老版本升上来的用户，或者习惯用搜狗、中州韵（Rime）的人，会自己装fcitx5。问题就出在这里：Qt程序对输入法框架的依赖非常“认死理”，它启动时会去找一个叫platforminputcontexts的插件目录，如果找不到对应框架的插件，就直接放弃中文输入。

之前我在Ubuntu 22.04上遇到过一模一样的情况，那次是因为Qt Creator是用AppImage格式装的，自带了一套Qt库，根本不去读系统目录里的输入法插件。这次在24.04上我又踩了一遍，顺手把排查思路和最终能落地的方案全部整理出来。

另外还要分清一个概念：Qt Creator本身分两种来源——一种是Ubuntu软件源里通过apt install qtcreator装的，另一种是Qt官方下载的安装包（带Qt库的）。两种方式的输入法插件路径完全不同，网上很多教程只讲其中一种，所以你照着操作没效果是很正常的。

这篇文章面向的人群很明确：

• 刚装完Ubuntu 24.04，想用Qt Creator开发但打不出中文的
• 系统里用的是fcitx5，GNOME桌面，重启好几次都没用的
• 被网上各种教程折腾过，im-config改了、环境变量设了、插件也装了，仍然无效的

我会按“问题根源 → 环境检查 → 完整配置 → 常见坑”的顺序来写，每一步都说明原理和操作意图，最后附一份排查速查表。素材主要来自我这两天的实操记录和我参考的一些社区经验，全程在Ubuntu 24.04真实环境下验证过。

2. 核心原因拆解：Qt程序与输入法框架之间的“桥”断了

2.1 Qt程序的输入法桥接机制

要理解这个问题，得先知道Qt程序是怎么“接上”输入法的。Qt程序本身只是一个普通进程，它不直接跟输入法对话，而是通过一个中间层——输入法框架（IBus、fcitx5、uim等）来交换信息。这个中间层在做的事情，就是把你敲键盘的原始事件转换成对应的文本候选词，再交还给Qt程序显示在输入框里。

具体到实现层面，Qt通过加载对应的输入法插件（一个.so文件）来建立连接。插件名字通常是libfcitxplatforminputcontextplugin.so或libibusplatforminputcontextplugin.so，放在Qt平台的插件目录下。

这个目录的位置，取决于Qt库是哪来的：

• 如果是apt安装的系统Qt，通常指向/usr/lib/x86_64-linux-gnu/qt5/plugins/platforminputcontexts/
• 如果是Qt官方安装包自带的Qt库，路径则在你的安装目录下，比如~/Qt/5.15.2/gcc_64/plugins/platforminputcontexts/

Qt Creator启动时会依据QT_QPA_PLATFORM_PLUGIN_PATH等环境变量去定位这些插件，实现一套libinputplugin的加载逻辑。

问题在于：如果你只给系统装了fcitx5，但Qt Creator找到的那个插件目录下没有libfcitxplatforminputcontextplugin.so，它就根本不会去加载fcitx5，自然弹不出中文候选框。

再补一刀——Ubuntu软件源的Qt和Qt官方安装包，两者的插件库可能版本不同，放的位置也不同。你要是用apt装了一套，又用官方包跑Qt Creator，就会出现“系统里明明有fcitx5插件，但Qt Creator就是加载不到”的情况。我这次排查时，dpkg -L fcitx5-frontend-qt5查出来的插件路径和Qt Creator实际读取的路径就对不上，这就是很多人照着教程操作还是无效的根源。

2.2 为什么Ubuntu 24.04上问题更明显

Ubuntu 24.04把系统默认输入法从IBus往Wayland环境下推了一把，GNOME对Wayland的支持也越来越完善。但这对fcitx5用户来说反而有点“卡位”：

• 在X11环境下，fcitx5通过XMODIFIERS、GTK_IM_MODULE、QT_IM_MODULE这些环境变量就能被各个程序找到。
• 在Wayland环境下，Qt程序需要走fcitx5的Wayland输入法协议或者通过qtwayland的桥接支持，情况比X11复杂不少，很多老版本插件根本没适配好。

另外一个容易被忽略的点：Ubuntu 24.04源里带的fcitx5框架更新得比较快，但Qt Creator（特别是从官方下的新版）内置的Qt库可能还停留在较旧的版本，对fcitx5的某些新API不兼容，表现出来就是你装了最新版fcitx5，但Qt Creator就是无法显示候选词。

所以，要彻底解决这个问题，不能只靠“装个包”就完事，得让下面这套链条每一环都通：

• 系统有fcitx5，且正常运行
• 环境变量设置正确，Qt程序能找到输入法
• Qt Creator能加载到对应框架的输入法插件
• 在Qt Creator内部，输入法候选框能正确弹出

这一节先把原理讲清楚了，下一节开始实际操作。

3. 完整配置流程：从环境准备到Qt Creator支持中文

3.1 第一步：确认桌面环境与输入法框架状态

动手之前，先弄清楚自己系统处于什么状态。在终端里执行：

bash复制echo $XDG_SESSION_TYPE
echo $QT_QPA_PLATFORM
im-config -m

第一个命令看当前会话是X11还是Wayland。如果你是在GNOME默认登录界面选“Ubuntu on Xorg”进来的，那XDG_SESSION_TYPE显示x11；如果直接用默认的“Ubuntu”那个选项，多半就是wayland。

第二个命令看Qt程序当前用的平台插件，一般是xcb（X11下）或者wayland。

第三个命令是看系统当前启用的输入法框架配置，如果输出里有fcitx字样，说明系统已经切到了fcitx框架。

然后确认fcitx5进程真的在跑：

bash复制ps -ef | grep fcitx5

如果没有输出，说明fcitx5没启动。先别急着去折腾Qt，得先把输入法本身跑起来。

在Ubuntu 24.04上安装fcitx5的完整命令我放在下面，按照一套装齐：

bash复制sudo apt update
sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt5 fcitx5-config-qt dbus-x11

其中：

• fcitx5：主程序框架
• fcitx5-chinese-addons：中文输入法引擎（包含拼音、双拼等）
• fcitx5-frontend-gtk3 / fcitx5-frontend-gtk4：让GTK程序能调起fcitx5
• fcitx5-frontend-qt5：提供Qt5的输入法插件，这个最关键，后面会细讲
• fcitx5-config-qt：GUI配置工具，方便管理输入法
• dbus-x11：某些程序在没有完整DBus环境时也能正确调用fcitx5

安装完以后，设置开机自启。Ubuntu 24.04的GNOME桌面没有传统的“启动应用程序”工具，需要手动建一个desktop文件：

bash复制mkdir -p ~/.config/autostart
cat > ~/.config/autostart/fcitx5.desktop << EOF
[Desktop Entry]
Encoding=UTF-8
Type=Application
Name=fcitx5
Comment=Start Input Method
Exec=fcitx5
Icon=fcitx
Terminal=false
X-GNOME-Autostart-enabled=true
EOF

注意，如果你之前用的是IBus，最好把IBus的自启关掉，否则可能会出现两个输入法抢焦点的情况：

bash复制gsettings set org.gnome.settings-daemon.plugins.keyboard active false

然后重启一次系统，或者至少注销再登录，让fcitx5彻底接管输入法。重启后确认一下进程状态，接着往下操作。

3.2 第二步：安装并校准Qt输入法插件

接下来是核心步骤：确保Qt Creator能加载到fcitx5的输入法插件。

先看看系统里到底有没有这个插件：

bash复制dpkg -L fcitx5-frontend-qt5 | grep platforminputcontext

正常会输出类似这样的内容：

code复制/usr/lib/x86_64-linux-gnu/qt5/plugins/platforminputcontexts/libfcitxplatforminputcontextplugin.so

如果输出为空，说明插件没装成功，重新执行一遍安装命令。

这里有个关键点：上面这个路径是Qt5的插件目录。如果你用的是Qt6版本的Qt Creator（一般从Qt官方下载的新版本），插件路径会变成/usr/lib/x86_64-linux-gnu/qt6/plugins/platforminputcontexts/。Ubuntu软件源里可能没有针对Qt6的fcitx5前端包，这时候需要装官方的fcitx5 Qt6模块。

查看你当前fcitx5的版本，然后从fcitx5的官方仓库或发行版源码包编译也可以，但对大多数人来说没必要那么折腾。我实测下来最简单的方式是确认你的Qt Creator实际用的是哪套Qt——这决定了插件该放哪个目录。

打开Qt Creator，菜单栏找到“工具 → 选项 → Kits → Qt Versions”，里面会显示Qt Creator当前使用的Qt库路径。如果是/usr/lib/x86_64-linux-gnu/qt5开头的，那是系统Qt5；如果是~/Qt/5.15.2/gcc_64这种，那是官方安装的Qt库。

针对这两种情况的解决方案：

情况A：系统Qt5（apt安装）

大多数情况下，fcitx5-frontend-qt5包装好后插件就在系统Qt5的插件目录里，Qt Creator直接就能识别。如果还是不行，可能是路径没被Qt Creator扫描到，需要在环境变量里显式指定。

情况B：Qt官方安装包自带的Qt库

这种情况最坑。Qt Creator启动时会优先加载自己目录下的Qt库，根本不去看系统/usr/lib/x86_64-linux-gnu/qt5/plugins这个路径。解决办法是把你刚找到的libfcitxplatforminputcontextplugin.so复制到Qt Creator自带的插件目录下：

bash复制cp /usr/lib/x86_64-linux-gnu/qt5/plugins/platforminputcontexts/libfcitxplatforminputcontextplugin.so ~/Qt/5.15.2/gcc_64/plugins/platforminputcontexts/

Qt 6的路径类似，替换成对应的Qt版本目录就行。

这里需要强调一下：复制插件的时候要确认库文件的依赖关系。用ldd查看一下这个.so文件依赖哪些库：

bash复制ldd /usr/lib/x86_64-linux-gnu/qt5/plugins/platforminputcontexts/libfcitxplatforminputcontextplugin.so

如果输出里出现libFcitx5Core.so.7这类依赖库，而对应的库文件在你的Qt目录里找不到，运行时就会报错。这种情况下，要么把依赖库一起复制过去，要么用符号链接指向系统库目录。

3.3 第三步：设置环境变量，打通Qt Creator与fcitx5

环境变量是另一个容易出错的环节。Qt程序要正确找到输入法，需要知道三件事：

• 用哪个输入法框架
• 输入法的XMODIFIERS设置是什么
• 对应平台下的输入法模块叫什么

把这几个变量写进系统级配置文件，让所有用户生效：

bash复制sudo tee /etc/environment << EOF
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx
SDL_IM_MODULE=fcitx
GLFW_IM_MODULE=ibus
EOF

解释一下各个字段：

• GTK_IM_MODULE=fcitx：让GTK程序（比如GNOME自带的一些对话框）用fcitx
• QT_IM_MODULE=fcitx：让Qt程序用fcitx，这是Qt Creator输入中文的关键
• XMODIFIERS=@im=fcitx：X11下的输入法标识，某些老程序靠这个识别输入法
• SDL_IM_MODULE=fcitx：SDL程序（比如一些游戏、模拟器）的输入法
• GLFW_IM_MODULE=ibus：这个留个缓冲，某些OpenGL程序对ibus的兼容性更好，但实际使用中不用太纠结

注意：/etc/environment这个文件只会在登录时读取，所以改完以后一定要注销重新登录，或者重启，否则不生效。

另外，如果是Wayland会话，可能还需要给Qt程序指定平台插件。大多数情况下不用手动指定，Qt Creator会自动选Wayland插件，但保险起见可以在Qt Creator的快捷方式或启动脚本里加一行：

bash复制export QT_QPA_PLATFORM=xcb

这只是个兜底方案，实际强制走xcb后Wayland的一些高分屏特性会丢失。我更推荐的做法是：先保持默认，测试能不能输入中文，不行再强制xcb。

3.4 第四步：修改Qt Creator的启动方式，让环境变量彻底生效

就算你改了/etc/environment，Qt Creator如果是从桌面图标启动的，某些版本可能会有缓存，环境变量的加载顺序不对。为了稳妥，我在~/.local/share/applications/下手动改了Qt Creator的desktop文件，把环境变量写进启动命令：

bash复制mkdir -p ~/.local/share/applications

先找到原来的desktop文件：

bash复制grep -r "qtcreator" /usr/share/applications/ ~/.local/share/applications/ 2>/dev/null

通常在/usr/share/applications/io.qt.qtcreator.desktop，把内容复制一份到用户目录：

bash复制cp /usr/share/applications/io.qt.qtcreator.desktop ~/.local/share/applications/

然后编辑：

bash复制nano ~/.local/share/applications/io.qt.qtcreator.desktop

找到Exec那一行，修改成：

bash复制Exec=env GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx XMODIFIERS=@im=fcitx /usr/bin/qtcreator %F

之所以用env命令，是因为它能在进程启动前先设置环境变量，避免桌面环境覆盖。如果你使用的是Qt官方安装包，把/usr/bin/qtcreator替换成你实际的启动路径，通常是~/Qt/Tools/QtCreator/bin/qtcreator。

改完保存，重新从应用菜单里启动Qt Creator。这时它读取的就是你显式设置的环境变量，不会再出现“系统环境变量改了但程序没读到”的情况。

3.5 第五步：在fcitx5里添加中文输入法并测试

环境变量和插件都处理完以后，还需要确认fcitx5里确实配了中文输入法。

打开“Fcitx5 Configuration”（启动命令是fcitx5-configtool或fcitx5-config-qt），进去后点击左下角的“+”，在列表里找到“Pinyin”或其他中文输入法，添加进去。

然后右键点击系统托盘里的fcitx5图标，确认当前布局是“键盘-英语”和“Pinyin”两个，切换快捷键（默认Ctrl+Space）能正常切换。

到这里，理论上的配置已经全部完成。打开Qt Creator，新建一个纯文本文件，试试Ctrl+Space切换输入法，敲几个拼音看候选词能不能弹出来。

我的实测结果是：按照这套流程配置完，注销再登录后，Qt Creator直接就能打出中文了，不需要额外操作。

4. 真实坑位记录：安装Qt Creator时最容易踩的暗坑

这一节整合了我这次在Ubuntu 24.04里折腾Qt Creator输入法时踩过的坑，以及我在网上看到的高频问题。有些坑跟输入法本身没关系，但如果不处理好，会让排查方向完全跑偏。

4.1 “系统里有fcitx5，但Qt Creator就是调不出来”

这是最常见的情况。我在Ubuntu 24.04新装系统后，apt install fcitx5过后，Terminal和Gedit都能用中文，唯独Qt Creator里怎么按Ctrl+Space都没反应。

排查步骤要按顺序来：

先确认fcitx5的插件是否存在于Qt Creator实际读取的目录。执行：

bash复制find /usr/lib -name "*fcitx*" -path "*platforminputcontexts*" 2>/dev/null

然后确认Qt Creator用的Qt库路径，如上文所述在“工具 → 选项 → Kits → Qt Versions”里看。两边路径对不上，就是这个原因。

解决办法就是我之前说的：要么把系统插件复制到Qt Creator的Qt目录，要么反过来，把Qt Creator设置成用系统Qt。

4.2 Qt Creator从官方下载的安装包启动时，找不到输入法插件

官方下载的Qt Creator，默认自带一套Qt库，这套库不在系统默认搜索路径下，所以它启动时不会自动加载/usr/lib/x86_64-linux-gnu/qt5/plugins里的插件。

解决思路我建议这样：先确认Qt Creator的Qt版本目录，然后直接把fcitx5的插件软链接过去。软链接比复制好维护，以后升级fcitx5不用重新拷：

bash复制ln -s /usr/lib/x86_64-linux-gnu/qt5/plugins/platforminputcontexts/libfcitxplatforminputcontextplugin.so ~/Qt/5.15.2/gcc_64/plugins/platforminputcontexts/

顺便把fcitx5的库目录也链接上，防止依赖找不到：

bash复制ln -s /usr/lib/x86_64-linux-gnu/libFcitx5Core.so.7 ~/Qt/5.15.2/gcc_64/lib/

注意版本号，执行前先用ls /usr/lib/x86_64-linux-gnu/libFcitx5*确认一下。

4.3 Wayland会话下FCITX5候选框不显示

我在Wayland下测试时发现一个现象：Qt Creator窗口能正常打开，但切出中文输入法后，候选框根本不出现在Qt Creator窗口旁边，而是孤零零地浮在屏幕角落或者干脆不显示。

这其实是fcitx5在Wayland下的Virtual Keyboard协议适配问题。如果遇到这种情况，我建议先临时强制Qt Creator走X11模式：

bash复制QT_QPA_PLATFORM=xcb qtcreator

如果强制xcb后能正常输入中文，说明Wayland的适配确实有问题。可以等fcitx5或Qt的新版本修复，或者暂时就用xcb模式跑，影响其实不大——就是高分屏缩放在某些环境下可能变模糊。

另外一个辅助思路：Ubuntu软件源的fcitx5-frontend-qt5可能不是最新版，fcitx5官方仓库里可能有更新的Qt模块。考虑到稳定性，我通常先用源里的版本，等确认有对应修复再升级，不建议一上来就跑天天编译的devel版本。

4.4 输入法候选框位置错乱

这个问题出现的频率也很高。我见过的情况是：候选框飘在屏幕左下角，而不是跟随光标。这通常是因为Qt程序没有正确获取光标位置信息，或者fcitx5无法通过程序获得当前输入区域的位置。

解决这个问题，可以在fcitx5配置里检查“Addons”里的输入法模块是否启用了“Input Method Position”或者“Active Input Method Position”等相关组件。fcitx5-config-qt里对应的选项有时候显示为“候选词跟随光标”相关开关，具体名称随版本有差异。

如果还是不行，检查环境变量QT_IM_MODULE是否跟你实际安装的fcitx5前端一致。装了fcitx5的qt5前端，变量名就是fcitx；有些发行版上写fcitx5也会被识别，但有些不行。我一般直接统一写成fcitx，兼容性最好。

4.5 重启后fcitx5没自动启动

这种现象在Ubuntu 24.04上特别常见，因为GNOME的会话管理器对自启项的识别比较“挑剔”。如果重启后发现fcitx5图标没出现，说明自启配置没生效。

除了前面提到的~/.config/autostart/fcitx5.desktop方式，还可以用im-config来切换用户级输入法配置：

bash复制im-config -n fcitx5

im-config会生成用户级的输入法环境变量配置，比手动改/etc/environment更贴近系统当前的机制。执行完以后注销再登录，fcitx5应该就会被自动拉起。

顺带提一个易错点：如果你之前装过fcitx4，系统里可能还残留着fcitx4的自启文件。fcitx4和fcitx5共存时会抢占输入法焦点，表现出来就是“fcitx5明明在跑，但程序里切不出中文”。遇到这种情况，直接卸载fcitx4相关包：

bash复制sudo apt remove fcitx fcitx-bin fcitx-config-common fcitx-frontend-all

不过卸载前确认一下没有其他程序依赖fcitx4，否则可能误伤。

5. 配置验证与自动化：一键排查你的Qt Creator输入法状态

配置完成后，很多人会担心“是不是真的生效了”。我建议用一个简单的方法快速验证环境变量是否被Qt Creator正确读取。

打开终端，启动Qt Creator前先打印环境：

bash复制env | grep -E "IM_MODULE|MODIFIERS"

如果输出里有QT_IM_MODULE=fcitx、GTK_IM_MODULE=fcitx、XMODIFIERS=@im=fcitx，说明环境变量生效了。

然后启动Qt Creator，在帮助菜单里找到“环境变量”之类的查看入口。Qt Creator有一个地方能显示当前所有环境变量：

菜单栏 “帮助 → About Plugins” 附近不直接显示，但在“工具 → 选项 → 环境 → System”里能看到部分环境。更直接的方式是在Qt Creator里打开“工具 → 外部 → 终端”，在终端里执行：

bash复制echo $QT_IM_MODULE

如果显示fcitx，说明Qt Creator启动时确实带了这个变量。

为了以后排查方便，我写了一个简单的脚本，放在~/check_fcitx_qt.sh，一行检查所有关键状态：

bash复制#!/bin/bash
echo "=== 输入法相关环境变量 ==="
env | grep -E "IM_MODULE|MODIFIERS" || echo "未检测到输入法环境变量"
echo ""
echo "=== fcitx5进程 ==="
pgrep -a fcitx5 || echo "fcitx5未运行"
echo ""
echo "=== Qt5输入法插件 ==="
find /usr/lib -name "*fcitx*platforminputcontext*" 2>/dev/null
echo ""
echo "=== Qt6输入法插件 ==="
find /usr/lib -name "*fcitx*platforminputcontext*" -path "*qt6*" 2>/dev/null
echo ""
echo "=== 当前会话类型 ==="
echo "XDG_SESSION_TYPE=$XDG_SESSION_TYPE"
echo "QT_QPA_PLATFORM=$QT_QPA_PLATFORM"

给脚本加上执行权限后，就能一键知道当前环境是不是具备支持Qt Creator输入中文的条件。

执行：

bash复制chmod +x ~/check_fcitx_qt.sh
~/check_fcitx_qt.sh

再看实际效果：如果fcitx5在跑、Qt5插件存在、环境变量正确，理论上Qt Creator输入中文已经没有阻碍了。

6. 常见问题速查表：各个来源、各个坑位一次性说透

我把网上高频出现的困惑整理成一张表，方便你按图索骥。表中的方案都在Ubuntu 24.04 + fcitx5 + Qt Creator环境下验证过或结合社区经验整理，优先级从上到下，从“最常见”到“较冷门”。

这张表里的每一个原因，我在前面的章节里都有对应的详细操作。如果你遇到了表里没写的问题，多半是上面某一层的组合——排查思路就是自上而下逐层确认。

另外一个容易忽略的坑：Qt Creator打开特定项目时，项目的kit设置了自定义的Qt版本，而这个版本可能是一个嵌入式的交叉编译Qt，它的插件目录在系统路径之外，即便你全局配置了fcitx5，那个特定的Qt版本也没有对应的输入法插件。遇到“所有Qt程序都能出中文，只有这个项目不行”的情况，多注意一下kit用的是哪个Qt。

7. 扩展建议：输入法相关的其他优化方向

解决了Qt Creator输入中文的问题，日常使用中还有几个场景也会受输入法影响，顺手一起说。

终端里的中文输入

如果你在Qt Creator内置终端窗口里也切不出中文，多半不是Qt Creator的问题，而是你系统的默认终端模拟器对fcitx5支持不好。Ubuntu 24.04自带的GNOME终端是VTE库，对fcitx5的支持还行，但如果你装的是其他终端模拟器，可能需要单独装对应的前端包。

VS Code或其他Electron程序

Electron程序对fcitx5的适配逻辑跟Qt类似，也是通过环境变量来找输入法模块。Ubuntu 24.04下VS Code如果打不出中文，解决办法跟Qt Creator基本一样——确认GTK_IM_MODULE和QT_IM_MODULE设置正确，然后在启动命令里加--enable-wayland-ime（针对Wayland会话）。

OpenGL程序的中文输入

如果你在Qt Creator里开发OpenGL相关的程序，运行时发现输入法没法用，大概率是SDL或GLFW的输入法模块没设置。之前我提过SDL_IM_MODULE=fcitx和GLFW_IM_MODULE=ibus，这个组合是我试过比较稳的。

为fcitx5添加更多中文输入方案

fcitx5自带的拼音够用，但如果你习惯双拼或五笔，可以额外安装：

bash复制sudo apt install fcitx5-table fcitx5-table-extra

装完在fcitx5配置里添加对应的输入法即可。

至于中州韵（Rime）的折腾，那是另一个“深坑”，以后有机会专门写一篇聊。

8. 实操总结：按这个顺序做，Qt Creator一定能输入中文

再帮你把关键步骤梳理一遍，照着这个顺序操作，基本能一步到位：

1. 安装fcitx5全家桶：sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt5 fcitx5-config-qt dbus-x11
2. 禁用IBus自启，设置fcitx5自启：im-config -n fcitx5，并确保~/.config/autostart/fcitx5.desktop存在
3. 设置系统级环境变量：sudo tee /etc/environment写入GTK_IM_MODULE=fcitx、QT_IM_MODULE=fcitx、XMODIFIERS=@im=fcitx、SDL_IM_MODULE=fcitx
4. 确认fcitx5插件路径，必要时复制或软链到Qt Creator的Qt目录
5. 注销重登录，启动Qt Creator，测试Ctrl+Space切换

这五步执行完，如果还不行，再回头看第4节的排查表格。

我个人实际操作中的体会是：绝大多数“装好了输入法但Qt Creator没反应”的案例，都不是因为fcitx5没装好，而是系统的环境变量没有被Qt Creator正确读取，或者Qt Creator用的Qt库和你的fcitx5插件不在同一个加载路径下。搞清楚“Qt Creator用的是哪一套Qt库”这件事，就成功了一大半。

最后再分享一个小技巧：如果你不想每次改环境变量都注销、登录，可以在终端里手动source /etc/environment，再直接在终端启动Qt Creator来临时验证。这样能快速判断配置是否正确，确认没问题了再注销重登，把配置固化下来，效率会高不少。

希望这篇记录能帮你少走点弯路。Ubuntu 24.04的Wayland环境还在不断改进，以后输入法的坑大概率会被官方慢慢填平，但养成分层排查的习惯，比背下来某个具体解决方案要管用得多。