果子西施把 DietPi 刷到开发板上，折腾了一天，系统跑起来了。你想打开一个中文文件名看看，结果屏幕上整整齐齐排了一串“□□□”和“????”，那一刻是真的会怀疑人生。我遇到过不止一次这种场面，而且每次帮别人排查时都会发现，很多人第一反应是“换系统”，其实没必要。Debian 系系统的 DietPi 只是默认没带中文字体而已，缺的其实就是一套通用中文字体包。今天这篇是这个“把海外系统逐步调教成适合中文环境使用”系列的第三篇，对应东方仙盟体系里的“练气期”，也就是最基础的入门阶段：先别想输入法、桌面美化和高级本地化，先把“中文能正常显示”这一件事做到位。
DietPi 不是不能显示中文，它是真的没有准备中文字库。所以这个阶段的核心任务非常明确：装一个面向通用环境的中文字体包。我会把原理、选型、实际操作步骤和踩过的坑一起讲完，看完你也能让你的 DietPi 变成一个不会看到满屏方块的中文友好系统。
1. 为什么 DietPi 装上中文就乱码：先弄懂“缺字体”和“编码错”是两回事
我见过很多新手在排查中文乱码时，把大量时间花在改 locale、改编码、改环境变量上，结果折腾半天下结论：“这个系统不支持中文。”其实它真的不是不支持，而是你根本还没把字库喂给它。先花点时间搞清楚乱码的来源，后面就不会乱撞了。
1.1 你以为的乱码，多半是“缺字形（tofu）”
很多人口中的“中文乱码”，实际上分两种完全不同的情况。第一种是编码错误，显示出来的是一堆看不懂的符号，比如 ä¸Âæ–‡ 这种，或者整片问号。这个属于语言环境（locale）和应用之间对字符编码的解读不一致，通常改一下 locale 或者终端编码就能解决。
第二种，也就是 DietPi 上最常见的情况，是编码本身没问题，文件确实被系统正确识别为中文，但系统里找不到任何一款能画出这些汉字的字体文件。于是字体渲染引擎就只能画一个占位方块出来，这个方块在排版圈有个专门的叫法：tofu，豆腐块。大家平时说的“中文全是方块”，其实不是乱码，而是字体层面的缺字，本质是字形缺失。
我自己判断这两种情况的土办法是：在终端里用 printf '中文测试\n' 输出一行中文，如果看到的是一串特奇怪的乱字符，那是编码问题；如果看到的是规规矩矩的方块，那就是字体问题。DietPi 一上来经常是后者，因为它是为轻量设备设计的精简系统，本着能省则省的原则，默认带的字体只覆盖拉丁字符和部分符号，CJK（中日韩统一表意文字）字体一个都没装。
1.2 fontconfig 回退机制：中文字库为什么必须是“通用包”
理解了豆腐块的来源，接下来要知道 Linux 桌面和应用是怎么决定用哪款字体来画你的字符的。大部分图形程序不会自己去翻字体文件，而是委托 fontconfig 这个字体配置与匹配库去选择。程序给出一个字体族名称，比如 sans-serif、serif、monospace，fontconfig 会在系统里按配置的优先级去找匹配的字体。这里有一个关键机制叫字体回退（fallback）：当字体族列表里的第一个字体没有覆盖某个字符时，fontconfig 会继续往下找，直到找到一款包含该字符的字体。
问题就出在这里。DietPi 默认配置下，排在前面的往往是 DejaVu Sans、Liberation Sans 这类只覆盖拉丁字符的字体，它们对汉字无能为力。fontconfig 沿列表往下找，发现后面根本没有 CJK 字体可以顶上，于是直接交出一个空白，渲染引擎就画成豆腐块了。
所以这个阶段最该做的事，就是给系统安装一款覆盖面足够广的中文字体，让 fontconfig 在匹配失败时有路可退。这也是为什么我一直强调核心是“通用中文字体包”。“通用”两个字很关键：它必须是被广泛测试过，可以进入 fontconfig 的回退链条，能被 Qt/GTK 程序正常调用的系统级字体包，而不是你从某个地方下载的零散 ttf 文件。Debian 仓库里打包好的通用的中文字体包，装完就能自动被全系统识别，不用额外配置路径，这才是省心方案。
1.3 中文适配要两条腿走路：字体管渲染，locale 管语言
再延伸一句，把中文适配想成两条腿。第一条腿就是字体，解决的是“字符画不画得出来”，属于渲染层；第二条腿是 locale，解决的是“程序界面用什么语言显示、字符串怎么排序、时间格式长什么样”，属于运行时环境层。
装字体包，只解决了第一条腿。你装完之后，中文文件名能正常显示了，浏览器看中文网页也没问题了，但如果程序界面还是英文，那不是字体的锅，而是系统的 locale 还是英文，程序没有启用中文语言资源。DietPi 的软件源基于 Debian 体系，绝大多数桌面程序都带中文翻译文件，但系统没有把语言环境切到中文时，程序默认就走英文分支。
这也是为什么我建议字体包和 locale 同步做，不要装完字体就以为万事大吉。这篇的重点虽然是字体包，但我会在后面专门用一节讲 locale 和字体优先级配置，否则你大概率会遇到“字能显示但菜单还是英文”的半吊子状态。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 实操选型：一款简单的中文字体包就已足够
DietPi 的软件仓库里，能安装的中文字体其实不少。为了不让新手挑花眼，我先给结论：轻量场景装 fonts-wqy-microhei，通用标准场景装 fonts-noto-cjk。大多数人的 DietPi 设备，选其中一个就够了。
2.1 安装前先让包管理处于干净状态
DietPi 本身是一个极度精简的 Debian 分支，底层用 apt 管包，但入口上有自己的 dietpi-update 和 dietpi-software。直接搜软件列表你会发现，DietPi 自己的软件菜单里并没有一个叫“中文字体”的选项，字体得直接让 apt 从 Debian 仓库装。动手前建议先做两件事：跑一次 dietpi-update 让系统和源都处于较新状态，再跑一次 apt update 刷新软件包索引。
DietPi 出于简化考虑，默认登录用户就是 root，所以很多教程里的 sudo 在 DietPi 上可以直接省略。如果你改了默认账户并用了普通用户，那就在命令前面手动加上 sudo，原理一样。需要注意的是，如果你在 DietPi 上装了 Docker 容器，容器里的中文显示问题是另一套逻辑，得在容器里单独装字体或者把宿主机的字体目录挂载进去，这一点放在后面踩坑部分细说。
命令执行顺序大概是：
bash复制dietpi-update
apt update
确保没有报错后，就可以用 apt-cache search 看一下仓库里可用的中文字体包，顺便确认包名拼写：
bash复制apt-cache search fonts | grep -E 'wqy|noto-cjk'
正常你能看到 fonts-wqy-microhei、fonts-wqy-zenhei、fonts-noto-cjk 这几个候选。下面直接进入安装。
2.2 轻量方案：fonts-wqy-microhei 的老式可靠
如果你是树莓派 Zero、老款香橙派这类内存和 SD 卡都很紧张的小设备，我强烈建议直接选 fonts-wqy-microhei。文泉驿微米黑是国产开源字体里非常有资历的一款，我念大学那会儿很多 Linux 发行版的中文显示都靠它。别看它体积不大，简体字、繁体字的常用字符覆盖都足够了，字符轮廓是矢量数据，缩放不糊。
安装命令非常干净：
bash复制apt install fonts-wqy-microhei -y
这个包安装后体积也就几兆字节，对 DietPi 这种轻量系统来说几乎可以忽略不计。装完先不要急着关终端，验证一下字体是否被 fontconfig 识别到了：
bash复制fc-list | grep -i wenquanyi
如果输出里有 WenQuanYi Micro Hei 和 WenQuanYi Micro Hei Mono 的字样，说明字体文件已经成功进入系统字体目录，并且能被 fontconfig 扫描到了。微米黑还有一个额外的好处，它自带了一个等宽变体 WenQuanYi Micro Hei Mono，对需要在终端里显示中文对齐的场景比较友好。
2.3 标准方案：fonts-noto-cjk 的全面覆盖
如果设备性能还行，或者你会把 DietPi 拿来当日常桌面系统、做中文媒体中心、跑一些需要渲染中文的网页服务，那我的首选是 fonts-noto-cjk。这个包的来头不小，它是 Google 和 Adobe 合作的成果，最早叫思源黑体，Google 把它纳入 Noto 字体家族后命名成了 Noto Sans CJK。它的字形设计偏现代，简体、繁体、日文汉字、韩文汉字都收在同一套字体体系里，并且针对不同地区的字形习惯提供了 SC（简体中文）、TC（繁体中文）、JP（日文）、KR（韩文）等不同子集。
安装命令：
bash复制apt install fonts-noto-cjk -y
装完验证：
bash复制fc-list | grep -i "noto sans cjk"
正常情况下你会看到 Noto Sans CJK SC、Noto Sans CJK TC 等族名。这里要提醒一下，Debian 源里的 fonts-noto-cjk 主包默认只包含 Regular 和 Bold 两个字重，日常显示足够，但如果要做海报或者需要 Light、Medium 等其他字重，得额外装 fonts-noto-cjk-extra。那个包体积相当大，DietPi 用户慎装，除非真的在做中文排版或需要在文档里用多种字重。
fonts-noto-cjk 的缺点是包体积不小，装完大概要占六七十兆的存储空间。对于现在主流的树莓派 4B、各类 8GB 存储以上的开发板来说完全不是问题，但如果你用的是 4GB 存储的老卡，就要掂量一下了。
2.4 字体包对比与“不要手动从别处拷贝”
我把 Debian 系几个常见候选放在一个表里，方便你根据实际设备选：
| 字体包 | 安装体积 | 中文字形风格 | 适合场景 |
|---|---|---|---|
| fonts-wqy-microhei | 小，约几 MB | 现代黑体，含等宽变体 | 老设备、轻量服务、存储紧张 |
| fonts-wqy-zenhei | 中等 | 黑体，内置部分点阵字号 | 老设备但需要大字点阵渲染 |
| fonts-noto-cjk | 较大，约 60-70MB | 现代黑体，覆盖简繁日韩 | 桌面、网页、媒体中心主力 |
| fonts-noto-cjk-extra | 很大 | 多字重、含 Serif 宋体 | 排版、设计、文档打印 |
| fonts-arphic-uming/ukai | 中等 | 明体/楷体 | 文档、复古排版、繁体阅读 |
这里我特别想提一个反面操作：不要为了追求某个特定字体，从网上零星下载 ttf 文件再手动扔到 /usr/share/fonts。我自己早年干过这事，从一个 Windows 系统里拷出字体想放到 Linux 下用，结果不仅字体授权有风险，手动拷贝还经常出现权限不对、字体缓存没刷新、fontconfig 优先级不对等一堆问题。Debian/DietPi 源里已经打包好的开源中文字体，安装后会自动执行字体刷新，系统各种程序立刻就能认到。折腾手动拷贝的时间，不如好好挑一个源里的包，这才是“通用中文字体包”的价值。
3. 装完字体后，还需要 Step：locale 与字体优先级的正确设置
字体装上去了，方块问题理论上已经解决，但很多人在这一步还是会踩坑：中文字能显示了，但某些情况下优先级不对，或者图形环境重启后又变回老样子。这一节集中处理安装之后的系统性收尾。
3.1 开启 zh_CN.UTF-8 locale 最直接
先看当前系统的 locale 状态：
bash复制locale
DietPi 默认情况下，LANG 变量大概率是 en_US.UTF-8 或者 C.UTF-8，反正不会是中文。要让系统和应用程序把消息切到中文，需要先生成中文字符集环境，再启用它。
Debian 系的 locale 配置文件是 /etc/locale.gen。打开文件，找到一行被注释掉的 zh_CN.UTF-8 UTF-8，去掉注释。用 sed 一条命令也能搞定：
bash复制sed -i 's/# zh_CN.UTF-8 UTF-8/zh_CN.UTF-8 UTF-8/' /etc/locale.gen
然后执行：
bash复制locale-gen
生成完成后再更新系统默认 locale：
bash复制update-locale LANG=zh_CN.UTF-8
这时最好彻底退出当前 SSH 连接并重新登录一次，或者执行 source /etc/default/locale 让会话读取新配置。重新登录后输入 locale，看到 LANG=zh_CN.UTF-8 就说明生效了。
有一点要注意：DietPi 自己也有一个语言配置入口，dietpi-config 里可以设置系统语言。但如果它的可选语言列表里没有 zh_CN.UTF-8，不要硬选其他相近项，直接用我上面说的手动修改 /etc/locale.gen 方式最可靠。
3.2 调整 fontconfig 让中文字体“排队靠前”
locale 设置好以后，有一些画面还是会不理想。比如中英文混排时，英文字体走 DejaVu，中文通过 fallback 走 Noto，两种字体风格不统一，看起来总是有点别扭。更极端的情况是某些老程序只认 fontconfig 返回的第一个 sans-serif 字体，根本不往后面做 fallback，于是中文又变回方块。
解决方案是给 fontconfig 写一个用户级优先级配置。Linux 下每个用户都可以建一个配置文件 ~/.config/fontconfig/fonts.conf，不需要动系统级目录。内容可以写成这样：
xml复制<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
<alias>
<family>sans-serif</family>
<prefer>
<family>Noto Sans CJK SC</family>
</prefer>
</alias>
<alias>
<family>serif</family>
<prefer>
<family>Noto Sans CJK SC</family>
</prefer>
</alias>
<alias>
<family>monospace</family>
<prefer>
<family>Noto Sans Mono CJK SC</family>
</prefer>
</alias>
</fontconfig>
这段配置的意思是：当程序请求 sans-serif、serif、monospace 这些通用字体族时，把对应位置替换成我指定的中文字体。如果你装的是文泉驿微米黑，就把 <family> 里的内容改成 WenQuanYi Micro Hei，等宽场景改成 WenQuanYi Micro Hei Mono。
写完保存后，执行一次：
bash复制fc-cache -fv
再验证一下当前匹配结果：
bash复制fc-match sans-serif
fc-match monospace
如果输出里已经出现 Noto Sans CJK SC 或者 WenQuanYi Micro Hei，就说明中文字体已经排到了通用字体族的前面。这个操作的价值在于让所有遵守 fontconfig 规则的程序，在拿“默认字体”的时候直接拿到中文字体，而不是先拿一个英文中文字体混搭半天。我用这个配置很多年，几乎解决了我所有 Linux 桌面上的中英混排字体割裂问题。
3.3 图形应用与浏览器的重启方式
字体配置改完以后，新的字体不会那么“自动”就出现在所有已经运转的程序里。很多应用启动时会把 fontconfig 的匹配结果缓存到进程里，你不重启它，它就倔强地继续用老字体渲染。尤其要注意的是 Chromium 系浏览器，它们会单独维护一张字体缓存表，你只关闭浏览器窗口再重开不一定生效，得彻底杀掉进程再启动。这个环节没什么技术含量，但它就是容易被忽略。
如果 DietPi 跑的是带桌面环境（LXDE、XFCE 这类），改完字体后建议注销当前桌面会话再重新登录。假如桌面服务用的是 LightDM，也可以执行：
bash复制systemctl restart lightdm
不过这种操作会把你当前打开的图形应用全部关掉，执行前记得先保存工作。很多人以为重启就行，其实关键是把“正在使用老字体记录的进程”清理干净，而不是把整个系统重启一遍。
3.4 SSH 远端渲染与本地字体没有关系
这里要专门给新手说一个容易绕晕的坑：你通过 SSH 远程登录 DietPi，然后在终端里看到中文乱码，这时你在服务器上装再多字体也没用，因为 SSH 终端里的中文是“你本地电脑上的终端软件”负责渲染出来的，服务器只负责把字节流发给你。服务器端做的是字符编码转换，而你本地终端负责把 UTF-8 字节按字形画出来。
所以如果你在 Windows 上用 Putty、MobaXterm 这类工具，发现 SSH 到 DietPi 以后中文乱码，第一步不是去服务器装字体，而是检查本地终端的字符编码是不是 UTF-8。绝大多数终端软件默认已经切到了 UTF-8，但有些老版本或者某些远程桌面工具会默认用本地系统编码，而 Windows 的中文地区默认编码过去往往是 GBK，两边一不对上，自然就乱码了。
还有一种情况是纯本地操作，DietPi 不带桌面，你直接接显示器在 tty 控制台上操作，输入中文命令或者看中文文件。Linux 的内核控制台本身基本不支持中文字体渲染，那已经不是换字体包的范畴了，得灌 fbterm 这类工具。DietPi 是轻量服务器系统，绝大多数人其实根本不碰本地 tty，所以这个话题我点一下即可，别陷进去。
4. 踩坑记录：实操中会遇到的典型问题
真实操作永远比教程曲折。我把自己在 DietPi 和同类 Debian 系系统上装中文字体会遇到的高频问题整理成速查，每个都是我或朋友实际碰到过的。
4.1 安装空间不够导致失败
fonts-noto-cjk 下载和安装大概需要占用六七十兆空间。一些老设备用的是 4GB 甚至更小的存储卡，系统本身就占了不少，余量可能只剩几十兆。apt 下载安装包时如果空间不足，会直接报错，而且报错信息挺隐晦，不是直接说“磁盘满”，而是报什么 No space left on device 或者干脆卡在 Reading package lists 之后。
所以不管装哪个字体包，我建议先看一眼剩余空间：
bash复制df -h /
如果根分区空间少于 200MB，就先别上 noto 了。两个选择：要么清理 apt 缓存 apt clean，腾出 /var/cache/apt/archives 里的下载包；要么干脆改用 fonts-wqy-microhei，它小到几乎没有安装压力。空间这件事真心不是小事，DietPi 跑起来后日志、Docker 镜像、下载缓存都会悄悄吃掉存储，等你想装软件时才发现没地方了，那种挫败感我太懂了。
4.2 装完还是方块？先刷缓存再重启应用
这是最让人抓狂的情况：明明 fc-list 里能看到中文字体，可浏览器打开中文网页依然方块。原因通常是字体缓存没有刷新，或者软件进程还在用旧缓存。Debian 系在安装字体包时原本会自动触发 fc-cache，但某些自定义安装流程或开机后手动放置字体的场景不会自动刷新。
我的处理顺序是：
bash复制fc-cache -fv
看到输出里有 /usr/share/fonts: caching, new cache contents 这种提示后，再完全退出并重启你正在看网页的浏览器。Electron 应用（比如 VS Code）也同理，它内部带一个 Chromium，字体缓存跟系统应用不一定同步，得整个退出再开。
4.3 中文文件名乱码与 tar 包编码问题
另一个我在实际维护中遇到过的问题，是用户上传了一个 zip 或 tar 包到 DietPi，解压后在终端用 ls 看到的中文文件名是乱码。这种问题的根源往往不等于 DietPi 缺字体或缺 locale，而是压缩包在 Windows 下打包时用的编码是 GBK，或者在 macOS 下打包时用了 NFC/NFD 不同的 Unicode 规范化形式。
在已经设置了 zh_CN.UTF-8 的终端里，用 ls 看到乱码，先用 file 确认文件名原始字节，然后试着用 unzip -O GBK 强制指定编码解压，或者用 convmv 做文件名编码转换。这类问题跟中文字体包没有关系，属于编码转换范畴。很多人在这个问题上反复重装字体，真的没必要。
4.4 字体渲染发虚或中文笔画过细
偶尔会有人问我，为什么不装 noto 后中文在低分辨率屏幕上看起来发虚。低分辨率下矢量字体的抗锯齿效果本来就不如点阵字体干净。DietPi 如果跑在 800x480 这种小屏幕上，要追求清晰，可以考虑在字体配置里对抗锯齿和微调方式做一些调整。最简单的是在用户 fonts.conf 里加入：
xml复制<match target="font">
<edit name="antialias" mode="assign"><bool>true</bool></edit>
<edit name="hinting" mode="assign"><bool>true</bool></edit>
<edit name="hintstyle" mode="assign"><const>hintslight</const></edit>
<edit name="rgba" mode="assign"><const>rgb</const></edit>
</match>
这个配置能保证大多数 LCD 屏幕上文字边缘没有明显的颜色溢出。不过字体渲染本身涉及个人观感，这类调优可以作为装机后的后期优化，不在练气期阶段强行追求完美。
5. 按场景直接抄作业：三套常用组合
为了避免你看完前面一大堆内容还是不知道装哪一个，我把自己的实测组合分成了三个典型场景，直接照着做就行。
5.1 纯服务器/无桌面：微米黑最小方案
如果你的 DietPi 只是当 NAS、Home Assistant、下载机、内网 DNS 这类后台服务用，图形界面基本不碰，顶多是通过网页管理面板显示中文内容，那我推荐最小方案：装 fonts-wqy-microhei，不额外做 fontconfig 自定义配置，locale 保持默认或改成中文随意。
bash复制apt install fonts-wqy-microhei -y
fc-list :lang=zh
这个场景里字体的作用不是给你看桌面，而是让跑在系统上的 Web 服务、Python 脚本、Netdata 面板在生成中文图表或渲染中文页面时，不至于因为系统没有 CJK 字体而出错。体积小、依赖少、不干扰系统，这是最稳的组合。
5.2 轻量桌面：文泉驿微米黑或 noto 二选一
DietPi 装了 LXDE、XFCE 这类轻量桌面后，中文显示的需求就上来了。文件管理器、文本编辑器、浏览器都要渲染中文。如果设备的硬件配置是树莓派 3B 同级或以下，我建议用 fonts-wqy-microhei；如果是树莓派 4B、各类 2GB 以上内存的 x86 小主机，直接用 fonts-noto-cjk 体验更舒服，字形更现代，高分屏下的清晰度也更好。
装完字体之后，别忘了我前面说的 locale 和 fonts.conf 那两步。桌面环境的中文化，字体和 locale 必须同时到位，否则系统菜单、文件管理器里的中文界面还是出不来。然后再注销重新登录一次，让桌面会话读新的字体配置，整个系统的中文界面才算真正落地。
5.3 Docker/容器服务：字体要从宿主机挂载进容器
最后一个场景