【Ubuntu】Fcitx 搜狗拼音无法在 VS Code 输入中文的修复方案

Ubuntu 下 Fcitx 搜狗拼音无法在 VS Code 输入中文的修复方案

问题描述

在 Ubuntu 系统中，Fcitx 上安装的搜狗拼音在其他应用里可以正常使用，但在 VS Code 中无法输入中文。

这类问题通常出现在 GNOME + Wayland + VS Code 组合下。核心修复思路不是重装输入法，而是：

让 VS Code 以 X11/XWayland 模式启动，并显式指定 Fcitx 输入法环境变量。

一、先检查 VS Code 安装方式

先执行：

which code

如果输出是：

/snap/bin/code

说明你装的是 Snap 版 VS Code。这类版本在输入法兼容上更容易出问题，建议先卸载。

卸载命令：

sudo snap remove code

二、安装官网 .deb 版 VS Code

从官网下载安装 .deb 包后，在下载目录执行：

cd ~/Downloads
sudo apt install ./code_*.deb

安装完成后再次检查：

which code

正常应输出：

/usr/bin/code

三、用 X11 模式启动 VS Code 进行修复

直接执行下面命令：

env GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx XMODIFIERS=@im=fcitx /usr/bin/code --ozone-platform=x11

这条命令做了两件事：

1. 指定 VS Code 使用 Fcitx 输入法环境
2. 强制 VS Code 使用 X11/XWayland，而不是原生 Wayland

只要这条命令启动后的 VS Code 能正常输入中文，说明问题已经解决。

四、设置成长期生效

方案 1：终端中输入 code 时自动生效

把下面这行追加到 ~/.bashrc：

alias code='env GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx XMODIFIERS=@im=fcitx /usr/bin/code --ozone-platform=x11'

然后执行：

source ~/.bashrc

以后终端里直接输入：

code

就会自动按修复后的方式启动 VS Code。

方案 2：从应用菜单启动也生效

先复制桌面启动器：

mkdir -p ~/.local/share/applications
cp /usr/share/applications/code.desktop ~/.local/share/applications/

再编辑文件：

nano ~/.local/share/applications/code.desktop

把其中的 Exec= 一行改成：

Exec=env GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx XMODIFIERS=@im=fcitx /usr/bin/code --ozone-platform=x11 %F

保存后重新登录系统，或者重新打开应用菜单中的 VS Code。

五、注意事项

不要把输入法环境变量写成：

export GTK_IM_MODULE=xim
export QT_IM_MODULE=xim

更适合当前场景的写法是：

GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx

这里的关键不是单纯改变量，而是 VS Code 必须走 --ozone-platform=x11。

六、最终可直接执行的命令

1. 卸载 Snap 版并安装 .deb 版

sudo snap remove code
cd ~/Downloads
sudo apt install ./code_*.deb

2. 临时启动验证

env GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx XMODIFIERS=@im=fcitx /usr/bin/code --ozone-platform=x11

3. 写入 ~/.bashrc

echo "alias code='env GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx XMODIFIERS=@im=fcitx /usr/bin/code --ozone-platform=x11'" >> ~/.bashrc
source ~/.bashrc

4. 修改桌面启动器

mkdir -p ~/.local/share/applications
cp /usr/share/applications/code.desktop ~/.local/share/applications/
sed -i 's#^Exec=.*#Exec=env GTK_IM_MODULE=fcitx QT_IM_MODULE=fcitx XMODIFIERS=@im=fcitx /usr/bin/code --ozone-platform=x11 %F#' ~/.local/share/applications/code.desktop

总结

这个问题的本质不是搜狗拼音坏了，也不是 Fcitx 没启动，而是 VS Code 在 Wayland 下的输入法兼容问题。

最终稳定可用的修复方式就是：

卸载 Snap 版 VS Code，安装官方 .deb 版，并让 VS Code 使用 --ozone-platform=x11 启动。

这套方案在 Ubuntu 下比较直接，也最省折腾。