企业官网建设流程全解析

手里这块 Jetson Orin Nano，买回来前两周我基本都在跑模型、调摄像头、装各种容器。新鲜劲一过，想写点中文笔记、回论坛上跟帖讨论一下调试心得，才发现一个大问题——系统里没有中文输入法。在普通 PC 上装 Ubuntu 中文输入法，搜索一下三分钟就能搞定，但到了 Orin Nano 这种 ARM 架构的板子上，坑一下就多了：JetPack 自带桌面跟标准 GNOME 不完全一样、软件源要选 ports 架构、fcitx5 和 ibus 到底用哪套也够纠结一阵。这篇文章把我这几台 Orin Nano 上折腾输入法的经验完整整理出来，从环境确认到安装配置，再到常见问题排查，照着做基本一次过。

1. 动手前先花十分钟：确认系统版本与输入法框架

1.1 先看清楚你的 JetPack 和桌面环境

在 Orin Nano 上装输入法，最忌讳的就是不看环境直接抄别人的 Ubuntu 教程。Jetson 的系统本体虽然是 Ubuntu，但它是基于 JetPack 来定制的，JetPack 不同版本对应的底层 Ubuntu 版本不一样，软件源的写法也不一样。你要是拿普通 x86 电脑的 Ubuntu 源直接怼上去，大概率会装出个四不像。

登录板子先跑三条命令：

uname -m cat /etc/nv_tegra_release cat /etc/os-release

uname -m会输出aarch64，这是 ARM 64 位架构，后面选软件源时非常关键。/etc/nv_tegra_release是 NVIDIA 发布 JetPack 时留下的版本标记文件。/etc/os-release里能直接看到 Ubuntu 版本号。目前最常见的组合是：JetPack 5.x 对应 Ubuntu 20.04，JetPack 6.x 对应 Ubuntu 22.04。如果你刚拿到板子刷了新镜像，大概率已经是 JetPack 6 的底子。

另外确认一下桌面会话。Jetson 的桌面环境是 GNOME，但 JetPack 不同版本默认走 Wayland 还是 X11 并不完全一样。这个细节直接影响环境变量怎么配、VNC 远程时候选框能不能正常跟随光标，后面章节我会专门讲。先确认这些，至少能避免装到一半发现源不匹配这种低级问题。

1.2 fcitx5 还是 ibus：选型思路

输入法框架主要有两套：fcitx5 和 ibus。GNOME 桌面默认集成的是 ibus，很多教程也顺着系统默认走，让你直接装 ibus-pinyin。但以我在 Orin Nano 上的实际体验，我强烈建议你优先考虑 fcitx5。

原因有三个。第一，Orin Nano 的板载内存只有 4GB 或 8GB，如果还跑着推理任务、ROS、各种容器，内存一直是紧巴巴的。fcitx5 的驻留内存占用比 ibus 体系小不少，而且它的启动速度更快。第二，Jetson 生态里大量工具是基于 Qt 写的，比如各种可视化标注工具、ROS 的 rviz，这些程序跟 fcitx5 的配合比跟 ibus 配合稳得多。ibus 在 Qt 程序里偶尔会碰上候选框不弹的尴尬。第三，fcitx5 的配置工具做得非常直观，改快捷键、调候选词数量、切简繁体，全在一个图形界面里搞定。

ibus 也不是不能用，后面第四章我会给出完整的备用方案和两者对比。但如果想少折腾，这一节看完直接跳到第二章，照着 fcitx5 的路线走就行。

2. 标准安装流程：换源、装包、配置环境变量

2.1 先换源：注意要用 ports 源

Orin Nano 上直接连 NVIDIA 官方源和 Ubuntu 官方源，在国内网络环境下速度非常不稳定。我试过裸源执行apt update，经常卡在某个连接上几分钟不动。换国内镜像源是第一步，但这里有个大坑：Jetson 是 aarch64 架构，不能用普通的x86_64源，必须用ubuntu-ports。

先备份原文件再修改：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo nano /etc/apt/sources.list

JetPack 6 / Ubuntu 22.04 的板子，把内容换成中科大源（下面这段是 jammy 版本）：

deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy main restricted universe multiverse deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-updates main restricted universe multiverse deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-backports main restricted universe multiverse deb https://mirrors.ustc.edu.cn/ubuntu-ports/ jammy-security main restricted universe multiverse

如果是 JetPack 5 / Ubuntu 20.04，就把三处jammy替换成focal。换完执行：

sudo apt update

我实测下来，换源之后apt update从原来可能卡住的几分钟缩短到十几秒。这一步不做好，后面装什么包都容易焦虑。

2.2 安装 fcitx5 全套与中文字体

换好源之后，直接安装这几个包：

sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-config-qt fcitx5-frontend-gtk3 fcitx5-frontend-qt5 fonts-noto-cjk

每个包的作用简单拆一下：fcitx5是主程序框架；fcitx5-chinese-addons提供了拼音引擎，没有它装个空框架等于白装；fcitx5-config-qt是图形化设置界面；两个fcitx5-frontend-*包负责让 GTK 和 Qt 程序跟输入法正确对接，这俩不装或者漏装，经常会出现打开某个软件死活切不出中文的问题。fonts-noto-cjk是中文显示字体，缺了这个，候选词能出来但选完之后屏幕上是一堆方框，观感非常崩溃。

如果你手里的板子还是 Ubuntu 20.04，apt 里搜不到fcitx5这个包，也别慌，可以降一级用老牌的fcitx加fcitx-googlepinyin，配置思路完全一样。或者干脆刷成新 JetPack，一步到位。

2.3 配置环境变量与默认输入法

装完包并不代表输入法能用，关键在环境变量。需要让整个图形会话知道“输入法模块是 fcitx5”，否则按下快捷键根本没反应。

执行im-config -n fcitx5把系统默认输入法指向 fcitx5，然后编辑/etc/environment：

sudo nano /etc/environment

在文件末尾加上这三行：

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

解释一下这三行的作用。GTK_IM_MODULE管 GTK 应用，比如 GNOME 自带的文本编辑器；QT_IM_MODULE管 Qt 应用，比如很多图形化 AI 工具；XMODIFIERS是个全局的 X 输入法修饰符，老式 XIM 程序靠它找到输入法。三个一起设置，基本就能覆盖绝大多数软件。

改完之后，重启板子。这里最容易被忽略的是：只重启 fcitx5 进程不够，要整个会话重新登录，让桌面环境重新加载环境变量。重启完打开终端，安Ctrl+Space试一下能不能唤出中文候选框。能出来，说明安装成功了。

3. 调教细节：快捷键、候选词与远程桌面场景

3.1 设置快捷键：激活输入法和中英切换

装是装上了，但默认快捷键不一定会让你顺手。运行fcitx5-config-qt打开设置，在“全局选项”里能找到输入法开关相关快捷键。

我最常用的方案是这样：激活/取消输入法用Ctrl+Space，中英文临时切换用左Shift。不要小看这个细节，写代码时经常要中英混输，如果把中英切换放在Ctrl+Space这种容易误触的位置，手腕会非常累。左 Shift 的好处是单手能按，而且输入英文时下意识按它不会切走输入法，只是临时切换到英文模式；再按一下又回到中文，整个过程不用挪手。

设置完快捷键之后，最好重新登录一次桌面会话。之前我在配置界面里改了快捷键，想着即时生效，结果进 Qt 程序里还是老样子，折腾半天发现是会话没刷新。

3.2 候选词数量、字体与输入习惯

fcitx5 默认候选词是 5 个，对 Orin Nano 这种动辄连接 4K 显示器的场景来说，其实可以调到 9 个。屏幕够大，候选词多选起来更快，尤其是输入名字、专业术语这种场景，第一页能覆盖更多组合，翻页次数明显减少。

字体大小也要单独说。JetPack 的 GNOME 桌面在高分屏下如果不做缩放，fcitx5 候选栏里的字会显得特别小。直接在 fcitx5 设置界面的“外观”里把候选字调大一到两号就行，不用去动系统缩放，影响面最小。

另外中文标点的自动转换，这个功能默认打开，写代码注释时注意一下半角/全角状态。fcitx5 的本地拼音引擎有词频学习能力，一个词只要你选过几次，后面再打同样的拼音，它会自动把那个词往前排。这个适应过程大概需要几天，用久了输入会越来越顺。不需要刻意去手动造词，日常用自然就会积累。

3.3 VNC 远程桌面场景：候选框为什么不跟随光标

用 Orin Nano 的人，很大概率是把它当无头设备来用，靠 VNC 远程连进去操作。我在远程场景里踩过一个非常典型的坑：明明本地键盘能唤出候选框，一旦用 VNC 连上，输入法也能激活，但候选框固定出现在屏幕角落甚至消失不见。

这个问题的根源在于远程会话的显示协议。如果 Jetson 当前跑的是 Wayland，而 VNC 那头拿到的是一个虚拟的显示输出，fcitx5 无法准确拿到当前光标的坐标，于是渲染候选框时就会跑偏。解决办法有两个方向。

第一个方向是让远程会话走 Xorg 而不是 Wayland。JetPack 里把登录桌面切换成 Xorg 会话，然后再启动 VNC 服务，候选框跟随光标就会恢复正常。第二个方向是不纠结跟随光标，直接接受候选框固定在角落的样式，用键盘上下键选词也行，只是视觉上不太舒服。我的建议是走 Xorg，这是个一劳永逸的解决方案，尤其你后续还要跑 ROS 可视化工具，Xorg 下的兼容性也更好。

4. 备选方案：ibus 的安装与两者取舍

4.1 ibus 安装和配置

如果你已经在 GNOME 桌面里用习惯了 ibus，或者因为某些原因不想换框架，那在 Orin Nano 上装 ibus 也不算麻烦。命令如下：

sudo apt install ibus ibus-pinyin

装完同样要切换默认输入法：

im-config -n ibus

环境变量部分，把/etc/environment里的三个变量改成 ibus 对应的值：

GTK_IM_MODULE=ibus QT_IM_MODULE=ibus XMODIFIERS=@im=ibus

ibus 在部分 Qt 应用里会出现候选框无法激活的问题，加一个环境变量可以缓解同步问题：

IBUS_ENABLE_SYNC_MODE=1

加完重启会话。ibus 的好处是不用额外装前端模块，GNOME 默认就带了相应集成，配置路径短。

4.2 到底该选哪一套：直接对比

我把自己在两套框架上的实测体验整理成一张表，方便你根据场景判断：

简单总结一下我的参考建议：如果你在 Orin Nano 上主要跑 GNOME 自带程序、浏览器、写写 Python，ibus 完全够用；但如果你装了 ROS、PyQt 标注工具、QGroundControl 这类 Qt 程序，fcitx5 会省心得多。我自己的 Orin Nano 最终全部统一到了 fcitx5，因为调试机器人项目时 Qt 工具出现的频率太高，不想在输入法上重复浪费时间。

5. 常见问题与排查实录

5.1 输入法切换无效、候选框不出现

这是最高频的问题，但九成都是环境变量没生效或者 fcitx5 进程没起来。先看进程：

ps -ef | grep fcitx

如果没有输出，手动启动fcitx5 &。如果进程在但还是切不出来，跑自带诊断命令：

fcitx5-diagnose

它会列出一堆环境变量检查结果和警告项，重点看GTK_IM_MODULE、QT_IM_MODULE、XMODIFIERS三行显示的值是否都是 fcitx。这里有个容易出问题的点：JetPack 桌面某些会话启动方式不会读取/etc/environment，需要把三行变量追加到~/.xprofile或者桌面环境的 autostart 脚本里。我的做法是/etc/environment和~/.xprofile都写上，反正不会冲突。

改完环境变量务必重新登录，只重启 fcitx5 进程是不行的，因为环境变量是会话级的，进程重启不会重新读取。

5.2 重启后输入法配置丢失

有一次我发现重启之后输入法还能用，但自己调好的快捷键全部恢复成默认。翻了一下 fcitx5 的配置目录，发现~/.config/fcitx5/profile文件权限不对，导致写入失败。

遇到这种情况，先把 fcitx5 进程杀掉，然后把~/.config/fcitx5整个目录重命名备份，再让 fcitx5 重新生成一份默认配置。之后重新打开fcitx5-config-qt设置一遍，一般就能正常保存。另外im-config生成的~/.inputrc文件如果被改动过，也会导致启动时的默认输入法框架判断错误，执行一次im-config -n fcitx5可以强制修正。

5.3 中文变成方框乱码

输入法能唤出来，候选词也正常，但选中之后屏幕上全是方框。这个基本是中文字体缺失。安装fonts-noto-cjk之后就能解决。如果想确认字体是否生效，用下面命令：

fc-match "Noto Sans CJK SC"

如果输出的是目标字体路径，说明系统已经能找到中文字体。另外，有些终端模拟器默认字体本身不支持中文，这跟输入法无关，需要在终端设置里单独改字体。终端里输入中文后乱码，优先查终端字体，而不是回头重装输入法。

5.4 4GB 内存版本卡顿：先别怪输入法

Orin Nano 的入门版本只有 4GB 内存，跑 JetPack 桌面本身就紧巴巴。如果你开着浏览器、容器、推理进程，再切一次输入法感觉系统明显卡顿，第一反应别赖 fcitx5——它是整个系统里最轻量的组件之一。先看看内存：

free -h

如果剩余内存常年不到 500MB，那卡顿跟输入法没有关系。缓解手段有几个：开 zram 压缩交换内存，关掉 GNOME 的动画特效，或者换一个更轻的桌面环境。输入法这边能做的，是尽量别开云拼音这类联网功能，减少不必要的后台任务。

5.5 高分屏下候选框模糊

接 4K 显示器跑 JetPack 的人越来越多，但 fcitx5 在高分屏下默认的候选条会有点糊。问题出在 Qt 程序的缩放策略。设置一下环境变量能解决：

export QT_AUTO_SCREEN_SCALE_FACTOR=1

也不要忘了在 fcitx5 设置界面里把候选字调大。我之前光调字体大小没设缩放变量，候选框里的字变大了但整个框模糊，设置了上面的变量再重启会话，就完全清晰了。

最后说点个人体会。Orin Nano 这套板子买回来，绝大多数人是奔着推理性能去的，装输入法这种“不务正业”的小事反而容易被忽略。但真到写笔记、写注释、跟同行交流的时候，输入法就是每天都得碰的东西。装完 fcitx5 之后，这块板子才真正从一台“训练机器”变成了一台能日常使用的开发电脑。顺手再把系统备份一次，刷完机装完输入法、装上常用工具后做一个镜像，后面不管怎么折腾都能快速恢复。祝你一次装好，少走我这些弯路。