需先安装fontconfig工具,再用fc-list :lang=zh查看系统识别的中文字体;若为空则需检查字体文件存在性、索引状态,并执行fc-cache -f -v强制刷新缓存。

要确认Linux系统里是否已装好中文字体,避免后续生成PDF、渲染网页或导出图表时出现方块、乱码或空白字符,必须先准确查出系统识别到的中文字体列表。
检查fc-list命令是否存在
执行 fc-list --version 或直接运行 fc-list,若提示 command not found,说明字体管理工具未安装。
CentOS/RHEL系请运行:yum install -y fontconfig mkfontscale;Ubuntu/Debian系请运行:sudo apt-get install -y fontconfig xfonts-utils。这一步是后续所有操作的前提,【缺少fontconfig会导致fc-list完全不可用】。
查看全部已安装的中文字体
直接执行命令:fc-list :lang=zh。
该命令会列出所有被fontconfig识别为支持中文(zh语言标签)的字体条目,每行包含字体文件路径、字体族名和style信息。如果终端返回空,说明系统当前没有可用的中文字体——不是没放字体文件,而是没完成索引或缓存刷新。
注意:有些字体虽物理存在但未被正确注册,fc-list :lang=zh 查不到即等于系统“看不见”,不能用于渲染。
精准筛选特定字体名称
方法一:用grep过滤关键字
fc-list :lang=zh | grep -i "simhei" —— 查黑体(不区分大小写)
fc-list :lang=zh | grep -i "msyh" —— 查微软雅黑
方法二:用正则匹配完整字体族名
fc-list | awk -F: '/zh/{if($2 ~ /SimSun|NSimSun/) print $0}' —— 一次性匹配宋体与新宋体
方法三:只显示字体族名,去重后排序
fc-list :lang=zh | sed 's/.*: \(.*\):.*/\1/' | sort -u
这步能快速看出系统实际“认出”的中文字体家族有哪些,比扫全量路径更直观。如果输出里只有“Noto Sans CJK”或“WenQuanYi Micro Hei”,说明你还没装Windows常见字体。
验证字体文件是否被正确加载
第一步:确认字体文件真实存在,例如检查宋体文件是否在目录中:
ls /usr/share/fonts/song/simsun.ttc
第二步:查看fontconfig是否为其生成了索引缓存:
fc-cache -fv |& grep -i song —— 加 -fv 参数可看到详细扫描过程,若此处无输出或报错,说明该目录未被纳入fontconfig搜索路径。
第三步:强制重建全局缓存并验证:
① 运行 fc-cache -f -v(【-f 表示强制刷新,跳过时间戳比对;不加可能漏掉新字体】)
② 再次执行 fc-list :lang=zh | grep 宋体











