字体可用性验证是做什么的
办公文档在不同平台打开时出现字体错位，根因通常是目标字体缺失或名称对不上。fontconfig 是 Linux 的字体配置框架：fc-list 列出系统已安装的字体与语言支持，fc-match 显示某个字体名实际会命中哪个字体。当业务文档要求微软系字体而系统只装了开源替代字体时，可以写别名规则把请求映射到已有字体，从而在不修改文档的前提下改善排版。
基本信息
| 查询已装字体 | fc-list，可按 :lang=zh 过滤中文字体 |
|---|---|
| 查询命中结果 | fc-match 字体名 |
| 别名配置 | /etc/fonts/local.conf 或用户级 ~/.config/fontconfig/ |
| 刷新缓存 | fc-cache -fv |
| 生效范围 | 系统级配置影响全部用户与图形应用 |
典型使用场景
- 文档排版错位排查：先确认请求的字体实际命中了哪一个
- 批量核查中文字体是否齐全，避免个别终端显示方块
- 为微软系字体名配置别名映射到已装的开源字体
- 交付前统一字体环境，减少不同终端显示差异
- 证书类或业务系统的打印排版问题定位，判断是否字体缺失导致
- 迁移后回归：对比迁移前后的字体命中结果，确认无意外变化
验证与别名配置
验证与别名配置
fc-list :lang=zh | head -20 # 列出可用的中文字体
fc-match SimSun # 看宋体请求实际命中哪个字体
fc-match 'Microsoft YaHei' # 看雅黑请求的命中结果
fc-match Arial # 西文字体命中情况
fc-cache -fv # 刷新字体缓存
# 别名映射示例（/etc/fonts/local.conf）：
# <?xml version="1.0"?>
# <!DOCTYPE fontconfig SYSTEM "fonts.dtd">
# <fontconfig>
# <alias><family>SimSun</family>
# <prefer><family>Noto Serif CJK SC</family></prefer>
# </alias>
# </fontconfig>
fc-match SimSun # 改完再次验证命中结果常用命令对照
| 命令 | 用途 | 判读要点 |
|---|---|---|
| fc-list | 列出已安装字体 | 确认字体族名与实际文件 |
| fc-list :lang=zh | 筛选中文字体 | 为空说明中文支持缺失 |
| fc-match 名称 | 查看命中结果 | 命中替代字体即存在映射 |
| fc-cache -fv | 重建字体缓存 | 新增字体或改配置后执行 |
| fc-pattern | 解析字体名属性 | 排查名称大小写与空格问题 |
排查文档字体问题建议按顺序进行：先用 fc-match 看请求命中什么，再决定是补装字体还是加别名映射；直接装一堆字体往往解决不了名称对不上的问题。
local.conf 属于 XML 配置，语法错误会让字体配置整体失效甚至影响字体缓存生成；修改后必须执行 fc-cache 并用 fc-match 验证，确认无报错再下发到其它机器。