1. 为什么要在树莓派4B上折腾WPS树莓派4B这块板子4核Cortex-A72、最高8GB内存跑个桌面环境日常写写文档完全够用。但真把它当轻办公主机使绕不开一个坎办公套件选谁。LibreOffice能用可国内环境下大量文档是.docx和.wps格式排版兼容性、字体渲染、表格样式这些细节LibreOffice打开经常跑版。WPS Office for Linux 官方只提供 x86_64 的 deb 包树莓派是 ARM 架构aarch64官方渠道根本没有对应版本。这就是标题里“ARM架构下WPS安装”这件事的核心矛盾——架构不匹配。我前后在树莓派4B上装过 Ubuntu 20.04、Ubuntu 22.04、以及树莓派官方的 Raspberry Pi OS64位踩过的坑从“装完打不开”到“打开全是方块字”再到“菜单栏字体糊成一团”基本把能遇到的都遇了一遍。这篇就把整套流程拆开讲清楚怎么在 ARM 架构上把 WPS 跑起来装完之后字体乱码怎么修以及那些官方文档里绝对不会写的细节。适合谁看手里有树莓派4B、想拿它当轻办公终端的人在 ARM 开发板上折腾桌面应用、被架构问题卡住的开发者以及单纯想搞清楚 Linux 字体配置逻辑的折腾党。不需要你有多深的 Linux 功底但基本的终端操作、apt、dpkg这些得会。先说结论省得你往下翻半天树莓派4B上装WPS走的是社区维护的 ARM64 移植包路线装完必须手动补中文字体并重建字体缓存否则界面和文档里的中文全是方框。下面一步步来。2. 装之前的准备工作与方案选型2.1 系统选择为什么我更推荐 Ubuntu 22.04树莓派4B能跑的系统不少Raspberry Pi OS64位、Ubuntu Server/Desktop 20.04、22.04、甚至 24.04 都行。但装 WPS 这件事上系统选择直接影响成功率。我的实测排序是Ubuntu 22.04 Desktop (arm64) Ubuntu 20.04 Raspberry Pi OS 64位。原因有几个。Ubuntu 22.04 的 glibc 版本2.35和依赖库版本比较新社区移植的 WPS 包大多是基于这个版本编译的依赖冲突最少。Ubuntu 20.04 的 glibc 是 2.31部分新版移植包会报GLIBC_2.34 not found之类的错得降级用旧包。Raspberry Pi OS 用的是 Debian 系包管理虽然一样但它的库版本和 Ubuntu 有差异字体配置路径也略有不同容易出幺蛾子。如果你还没装系统直接上 Ubuntu 22.04 Desktop arm64 镜像用 Raspberry Pi Imager 写卡就行。装系统时记得在 Imager 的高级选项里提前配好 WiFi、SSH 和用户名省得接显示器键盘折腾。提示树莓派4B的 2GB 内存版本跑 Ubuntu Desktop 会比较吃力WPS 打开大文档容易卡。建议至少 4GB8GB 最舒服。如果只有 2GB考虑用 Ubuntu Server 轻量桌面XFCE或者干脆别装桌面版 WPS用网页版替代。2.2 依赖环境检查先看架构和库版本装之前先确认几件事避免装到一半发现方向错了。打开终端先看架构uname -m树莓派4B 64位系统应该输出aarch64。如果输出armv7l说明你装的是32位系统那 WPS 基本没戏——社区移植包几乎都是 arm64 的32位 ARM 的 WPS 移植极其罕见。这种情况要么重装64位系统要么放弃。再看系统版本和 glibclsb_release -a ldd --version | head -1Ubuntu 22.04 对应 glibc 2.3520.04 对应 2.31。记下这个版本号后面选移植包时要用。然后确认几个关键依赖在不在dpkg -l | grep -E libc6|libfreetype6|libx11-6|libgl1|libglib2.0-0这些是 WPS 运行的基础库。Ubuntu Desktop 默认都装了Server 版可能需要手动补。缺的话sudo apt update sudo apt install -y libc6 libfreetype6 libx11-6 libgl1 libglib2.0-0 libsm6 libice6 libxrender1 libxext6 libxfixes3 libxi6 libxtst6 libxrandr2 libxcursor1 libgtk-3-02.3 方案对比三条路各自的坑在 ARM 上跑 WPS实际可行的路线就三条我把它们摆出来对比一下。方案原理优点缺点推荐度社区 ARM64 移植包有人把 x86 的 WPS 重新编译/打包成 arm64原生运行性能好体验接近官方版本旧更新慢来源需甄别高Box86/Box64 转译用转译层跑 x86 版 WPS能用最新官方版性能损耗大稳定性差配置复杂低网页版 WPS浏览器里用零安装跨架构依赖网络功能受限大文档卡中社区移植包是主流选择。它的本质是有人拿到了 WPS 的源码或二进制针对 arm64 重新构建打包成 deb。这类包在 GitHub 和一些技术论坛上能找到版本通常停留在 2019 或 2021 版。别嫌旧办公够用。Box86/Box64 转译这条路我试过能跑起来但打开一个 10 页的文档要等十几秒滚动还掉帧输入法偶尔失灵。树莓派4B的 CPU 性能撑不起这种转译开销不推荐。网页版适合应急比如临时改个文档。但你要处理复杂表格、宏、或者离线办公网页版顶不住。所以下面我按社区 ARM64 移植包这条路线展开。3. 核心实操ARM64 版 WPS 的安装全过程3.1 获取移植包与校验移植包一般以.deb形式发布文件名类似wps-office_11.1.0.xxxx_arm64.deb。来源上GitHub 上搜 “wps office arm64 deb” 能找到几个维护仓库另外一些国内的 ARM 开发板社区也有分享。拿到包之后先校验再安装这一步别省。原因很简单来源不明的 deb 包可能带恶意脚本安装时以 root 权限执行风险不小。# 看包的架构信息 dpkg-deb -I wps-office_xxx_arm64.deb | grep Architecture # 应该输出 arm64 # 看包里的安装脚本重点看 postinst 和 preinst dpkg-deb -e wps-office_xxx_arm64.deb ./control_dir cat ./control_dir/postinstpostinst是安装后执行的脚本正常的话就是建软链接、更新桌面数据库、刷新字体缓存这些。如果里面出现curl下载外部文件、wget拉脚本执行、或者往/etc写奇怪配置直接删包别装。注意校验这一步花不了两分钟但能挡掉大部分风险。我见过有人图省事直接dpkg -i结果装完系统多了个开机自启的挖矿进程。别赌。3.2 安装依赖与正式安装依赖前面 2.2 节已经列了这里再补几个 WPS 特有的sudo apt install -y libxdamage1 libxcomposite1 libxkbcommon0 libnspr4 libnss3 libcups2 libdbus-1-3 libatk1.0-0 libatk-bridge2.0-0 libpangocairo-1.0-0 libpango-1.0-0 libcairo2 libasound2这些是图形界面、打印、输入法、音频相关的库。缺了不一定装不上但运行时会崩。正式安装sudo dpkg -i wps-office_xxx_arm64.debdpkg装完大概率会报依赖错误这是正常的因为 deb 包声明的依赖可能和你的系统对不上。接着跑sudo apt install -f让apt自动补齐缺失的依赖。这一步会联网下载确保网络通畅。装完之后验证一下which wps which wpp which etwps是文字wpp是演示et是表格。三个都能找到路径说明装上了。3.3 首次启动与常见报错处理第一次启动别直接点图标从终端跑这样报错能直接看到wps常见的几个报错和处理方式报错一error while loading shared libraries: libXXX.so.X: cannot open shared object file缺库。把libXXX.so.X这个库名记下来用apt-file或直接搜sudo apt install apt-file sudo apt-file update apt-file search libXXX.so.X找到对应的包名装上即可。报错二GLIBC_2.34 not found你的系统 glibc 版本低于移植包要求。Ubuntu 20.04 上装新版移植包容易遇到。解决办法是换一个针对 glibc 2.31 编译的旧版移植包或者升级系统到 22.04。报错三启动后闪退终端无输出大概率是图形环境问题。试试加参数启动wps --no-sandbox或者检查DISPLAY环境变量是否设置正确。SSH 远程启动的话需要 X11 转发。报错四界面能出来但菜单栏一片空白字体问题下一章专门讲。4. 字体修复从方块字到正常显示4.1 为什么 ARM 版 WPS 字体问题特别严重字体乱码这事x86 版 WPS 也会遇到但 ARM 移植版更严重。原因有两层。第一层是字体缺失。WPS 默认依赖一批中文字体比如“宋体”“黑体”“仿宋”“楷体”这些在 Windows 上是系统自带的Linux 上默认没有。x86 版 WPS 的 deb 包会捆绑一部分字体但 ARM 移植包为了减小体积经常把字体剥离了导致装完就是一堆方框。第二层是字体配置路径差异。Linux 的字体配置由 fontconfig 管理配置文件在/etc/fonts/和~/.config/fontconfig/。ARM 发行版的 fontconfig 默认配置和 x86 版有细微差别比如字体缓存目录、优先级顺序。WPS 内部又有一套自己的字体映射逻辑两套东西对不上就会出现“明明装了字体但 WPS 不认”的情况。理解这两层修复思路就清楚了先补字体文件再配 fontconfig 映射最后重建缓存。4.2 补齐中文字体文件最直接的办法是从 Windows 系统拷贝字体。需要的核心字体simsun.ttc宋体simhei.ttf黑体simkai.ttf楷体simfang.ttf仿宋msyh.ttc微软雅黑msyhbd.ttc微软雅黑粗体这些文件在 Windows 的C:\Windows\Fonts\目录下。拷贝到树莓派上放到/usr/share/fonts/truetype/winfonts/目录sudo mkdir -p /usr/share/fonts/truetype/winfonts sudo cp /path/to/fonts/*.tt[cf] /usr/share/fonts/truetype/winfonts/ sudo chmod 644 /usr/share/fonts/truetype/winfonts/*如果手头没有 Windows 机器也可以用开源字体替代。文泉驿系列、思源系列都是不错的选择sudo apt install -y fonts-wqy-zenhei fonts-wqy-microhei fonts-noto-cjkfonts-noto-cjk是 Google 和 Adobe 合作的开源中文字体覆盖率高字形也不错。装完之后 WPS 里把默认字体映射到 Noto Sans CJK 也能用就是和 Windows 文档的排版会有细微差异。提示从 Windows 拷贝字体涉及版权问题个人使用一般没人管但别用于商业分发。开源字体没这个顾虑长期用建议逐步迁移到思源或 Noto。4.3 fontconfig 映射配置光有字体文件还不够WPS 里文档指定的“宋体”得能映射到实际存在的字体上。这就需要写 fontconfig 规则。在/etc/fonts/local.conf里加映射?xml version1.0? !DOCTYPE fontconfig SYSTEM fonts.dtd fontconfig match targetpattern test namefamilystringSimSun/string/test edit namefamily modeassign bindingstrong stringNoto Serif CJK SC/string /edit /match match targetpattern test namefamilystring宋体/string/test edit namefamily modeassign bindingstrong stringNoto Serif CJK SC/string /edit /match match targetpattern test namefamilystringSimHei/string/test edit namefamily modeassign bindingstrong stringNoto Sans CJK SC/string /edit /match match targetpattern test namefamilystring黑体/string/test edit namefamily modeassign bindingstrong stringNoto Sans CJK SC/string /edit /match /fontconfig这段配置的意思是当程序请求“SimSun”或“宋体”时fontconfig 自动把它替换成“Noto Serif CJK SC”。bindingstrong表示强制替换优先级最高。如果你装了 Windows 字体映射目标改成SimSun本身就行或者干脆不写映射让 fontconfig 自己找。4.4 重建字体缓存并验证配置写完重建缓存sudo fc-cache -fv-f强制刷新-v显示详细过程。跑完会看到扫描了多少字体目录、缓存了多少字体。验证字体是否被识别fc-list | grep -i noto.*cjk fc-list :langzh | head -20第一条看 Noto CJK 在不在第二条列出所有支持中文的字体。如果列表是空的说明字体没装对或者缓存没建好。再验证映射规则fc-match 宋体 fc-match SimSun正常应该输出NotoSerifCJK-Regular.ttc: Noto Serif CJK SC之类的结果。如果输出的是DejaVuSans.ttf这种不含中文的字体说明映射没生效检查local.conf的语法和路径。全部搞定后重启 WPS中文应该就正常了。5. 常见问题排查与实操避坑5.1 问题速查表把我在树莓派4B上遇到过的典型问题整理成表方便对照排查。现象可能原因排查命令解决方式装完找不到 wps 命令安装未完成或路径未加入dpkg -L wps-office | grep bin重新dpkg -i并apt install -f启动闪退无提示图形库缺失或 DISPLAY 未设echo $DISPLAY补装 libgtk-3-0 等检查 X11界面中文全是方块中文字体缺失fc-list :langzh装 Noto CJK 或拷贝 Windows 字体文档中文正常但菜单乱码WPS 内置字体映射问题查看~/.config/Kingsoft/配 fontconfig 映射重建缓存打开大文档卡死内存不足或交换分区小free -h加 swap或换 8GB 版树莓派输入法无法输入中文fcitx/ibus 未配置im-config -l装 fcitx5 中文输入法引擎打印乱码CUPS 字体路径问题lpstat -t配置 CUPS 使用系统字体保存后排版跑版字体替换导致度量差异对比原文档尽量用相同字体或接受差异5.2 输入法配置这个隐藏坑WPS 装好了、字体也修了结果发现中文打不进去——这是很多人卡住的下一步。树莓派 Ubuntu 默认可能没装中文输入法框架。装 fcitx5 和拼音引擎sudo apt install -y fcitx5 fcitx5-chinese-addons fcitx5-frontend-gtk3 fcitx5-frontend-qt5然后配置环境变量编辑~/.pam_environment或/etc/environmentGTK_IM_MODULEfcitx QT_IM_MODULEfcitx XMODIFIERSimfcitx注销重登fcitx5 应该就起来了。托盘里能看到图标CtrlSpace切换中英文。WPS 是 Qt 应用所以QT_IM_MODULEfcitx这条特别关键。少了它WPS 里就是打不出中文。5.3 性能调优的几个实操心得树莓派4B性能有限WPS 跑起来想流畅有几个地方可以调。关掉动画和特效。WPS 设置里找“皮肤和外观”把动画效果关掉。Ubuntu 桌面本身的动画也建议关用 GNOME Tweaks 把窗口动画调成最简。加大 swap。4GB 内存的树莓派开 WPS 加浏览器容易爆内存。加个 2GB 的 swap 文件sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo /swapfile none swap sw 0 0 | sudo tee -a /etc/fstab用 zram 代替传统 swap。zram 在内存里做压缩交换比磁盘 swap 快得多对树莓派这种 SD 卡设备尤其友好sudo apt install -y zram-tools装完默认就启用了swapon --show能看到 zram 设备。超频。树莓派4B 可以超到 2.0GHz编辑/boot/firmware/config.txtUbuntu 22.04 路径或/boot/config.txt旧版over_voltage6 arm_freq2000超频有风险散热得跟上。没装风扇或散热片的话别超会降频反而更慢。注意超频导致的稳定性问题随机死机、文件系统损坏不在保修范围。SD 卡上的系统尤其怕突然断电超频前先备份重要数据。5.4 版本选择与更新策略社区移植包版本更新慢这是事实。我的建议是能用就别乱升。办公软件稳定压倒一切新版本带来的新功能在树莓派上意义不大反而可能引入新的依赖问题。如果确实需要新版本先在一个独立环境里测试确认没问题再替换生产环境。测试方法把新 deb 装到另一张 SD 卡上或者用 Docker 容器模拟虽然 WPS 在容器里跑图形界面比较麻烦。另外WPS 会提示升级别点。ARM 版没有官方升级通道点了要么失败要么把现有版本搞坏。6. 这套方案的实际体验与边界我在树莓派4B 8GB 版 Ubuntu 22.04 上跑了大概三个月日常处理文档、表格、偶尔做点简单演示整体可用。打开 20 页以内的文档基本秒开50 页以上的会卡顿几秒复杂表格滚动有轻微掉帧。输入法配好之后中文输入流畅字体显示正常和 Windows 上的排版差异在可接受范围内。但它有明确的边界。别指望它替代主力办公机。宏、VBA、复杂图表、大文档协作这些场景树莓派4B 的性能和 ARM 版 WPS 的兼容性都撑不住。它适合的是轻量文档处理、应急修改、学习 Linux 桌面环境、以及作为备用终端。最后分享一个我踩过的坑有次系统更新后 WPS 突然打不开了排查半天发现是libfreetype6被升级到了不兼容的版本。解决办法是锁定版本sudo apt-mark hold libfreetype6apt-mark hold让这个包不再自动升级。类似的libc6、libglib2.0-0这些核心库如果升级后出问题也可以用这招回退。升级前先apt-mark showhold看看有没有被锁的包心里有数。这套流程走下来树莓派4B 上跑 WPS 这件事就算落地了。核心就三块选对系统、装对包、修好字体。每一块都有坑但坑都不深耐心点都能过。