Google Colab中Matplotlib字体缺失原因及安装配置方法问询

一、字体管理核心机制 #

Matplotlib 不内置任何第三方商业/开源字体，官方文档列出的5种字体族（serif、sans-serif、cursive、fantasy、monospace）只是逻辑分类标签，不是随安装包分发的实体字体资源。

• Matplotlib 启动时会扫描系统字体目录，把扫描到的字体按字形特征归类到对应字体族下，绘图时按配置的优先级匹配可用字体
• 纯净Linux环境（包括Google Colab默认运行容器）仅预装DejaVu、Liberation等少量开源无衬线/衬线字体，没有匹配cursive（手写花体）、fantasy（装饰艺术字体）分类的字体资源，因此这两个字体族默认无法调用，属于正常现象，不是程序bug。

二、通用字体配置流程（本地/云端环境通用） #

不管是本地Linux环境还是Colab这类云端容器，安装字体的流程完全一致：

• 安装字体文件到系统目录
  系统级安装：Debian/Ubuntu系可直接通过apt源安装字体包，自定义ttf/otf字体文件可直接拷贝到/usr/share/fonts/自定义子目录
  用户级安装：无需root权限，把字体文件放到~/.fonts/目录即可
• 清除Matplotlib字体缓存
  字体安装后不生效90%是缓存问题，先执行以下代码获取Matplotlib缓存路径，手动删除路径下的fontlist-*.json文件即可：

  import matplotlib as mpl
  print(mpl.get_cachedir())
  

  Colab环境可直接执行shell命令一键清理：rm -rf ~/.cache/matplotlib
• 重启Python运行时
  清理缓存后必须重启内核/运行时，Matplotlib才会重新扫描系统字体，生成新的字体映射列表。
• （可选）手动指定字体族映射
  如果需要让cursive这类默认无匹配的字体族生效，安装好对应手写类字体后，可直接修改配置指定映射关系：

  import matplotlib as mpl
  # 把cursive字体族的优先级最高字体设置为你安装的手写字体，比如Comic Sans MS
  mpl.rcParams['font.cursive'] = ['Comic Sans MS']
  mpl.rcParams['font.family'] = 'cursive'
  

三、Comic Sans MS 安装失败排查 #

执行sudo apt install msttcorefonts -qq后仍找不到字体，核心原因是安装参数不对：

• Debian/Ubuntu源中微软核心字体包ttf-mscorefonts-installer安装时会弹出EULA确认窗口，加-qq参数会默认拒绝协议，导致字体文件根本没有被下载安装。
• 正确的无交互安装命令如下，先提前写入协议确认配置再安装：

  echo "ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true" | sudo debconf-set-selections
  sudo apt install ttf-mscorefonts-installer -y
  

• 安装完成后按前述流程清缓存、重启运行时，可执行以下代码验证字体是否被正确识别：

  from matplotlib import font_manager
  # 打印所有带Comic关键字的已识别字体
  print([f.name for f in font_manager.fontManager.ttflist if 'Comic' in f.name])
  

  输出列表包含Comic Sans MS即代表配置成功。

四、同灵活性替代库推荐 #

如果觉得Matplotlib字体配置过于繁琐，可选择以下能力相当、默认配置更友好的可视化库：

• Seaborn：基于Matplotlib封装，默认样式美观，字体配置逻辑与Matplotlib完全兼容，学习成本极低
• Plotnine：语法对齐R语言ggplot2，采用图层化绘图逻辑，字体配置直观，出图风格统一规范，灵活性不输Matplotlib
• Altair：基于Vega-Lite的声明式可视化库，默认字体渲染效果优秀，无需复杂配置即可生成符合出版要求的统计图表

内容的提问来源于stack exchange，提问作者dotdashdashdash