Linux 命令速查
系统管理 man fc-cache

fc-cache

重建 fontconfig 字体缓存

返回

补充说明

fc-cache 扫描字体目录,为 fontconfig 生成或更新字体索引缓存,使新安装的字体能被 fc-list、GTK/Qt 应用和浏览器立即识别。它属于 fontconfig 套件。

默认扫描系统字体目录(/usr/share/fonts、/usr/local/share/fonts、~/.local/share/fonts 等)以及配置中声明的目录。常用 -f 强制重建、-v 显示过程、-r 递归、-s 只处理系统目录。用户缓存通常位于 ~/.cache/fontconfig。

注意:安装字体后一般只需 fc-cache -f -v;权限问题会导致缓存写入失败。缓存损坏时可删除 ~/.cache/fontconfig 后重建。fc-cache 不负责安装字体,只更新索引。

新字体未生效时,先用 fc-list 确认是否被扫描到,再检查字体文件权限和目录是否在 fontconfig 配置中。应用可能需要重启才能重新读取字体列表。

语法

fc-cache [选项] [目录 ...]

选项

  • -f / --force:强制重建缓存;
  • -v / --verbose:显示扫描过程;
  • -r / --recurse:递归扫描子目录;
  • -s / --system-only:只处理系统字体目录;
  • --version:显示版本。

实例

# 安装字体后强制重建并显示过程
fc-cache -fv

# 只重建用户字体目录
fc-cache -f ~/.local/share/fonts

# 只处理系统目录
sudo fc-cache -fs

# 验证新字体已被识别
fc-list | grep -i "Noto Sans CJK"

# 清理用户缓存后重建
rm -rf ~/.cache/fontconfig && fc-cache -f

参考链接