Matplotlib未读取~/.config/matplotlib/matplotlibrc配置文件求助

我已将配置内容放入~/.config/matplotlib/matplotlibrc文件中，但通过Python查询发现Matplotlib仍在使用默认配置文件：

>>> import matplotlib
>>> matplotlib.matplotlib_fname()
'/Users/home/Library/Python/3.10/lib/python/site-packages/matplotlib/mpl-data/matplotlibrc'

根据文档说明，.config目录下的配置文件应具有优先级，但我的配置并未生效。我尝试重启终端无效，将配置文件放在Python工作目录时可正常读取，但始终无法识别.config目录下的文件。我参考相关帖子删除了.matplotlib目录，但启动Python后该目录会被重建，问题仍未解决。我使用的是运行MacOS 14.4.1的MacBook，请问问题出在哪里？

可能的原因及解决方法 #

• 检查目录与文件权限
  MacOS下权限问题是常见诱因，确保~/.config/matplotlib目录及配置文件对当前用户有读写权限，在终端执行：

  chmod -R 755 ~/.config/matplotlib
  chmod 644 ~/.config/matplotlib/matplotlibrc
  

• 确认配置路径优先级与环境变量
  先打印Matplotlib实际识别的配置目录，验证是否指向~/.config/matplotlib：

  import matplotlib
  print(matplotlib.get_configdir())
  

  如果输出不是预期路径，检查是否有环境变量MPLCONFIGDIR篡改了默认设置：

  echo $MPLCONFIGDIR
  

  若有输出，执行unset MPLCONFIGDIR后重新测试。

• 排查Python环境的用户目录差异
  不同Python安装方式（系统自带、Homebrew、pyenv等）的用户配置路径可能不同，先查看当前Python的用户基准目录：

  import site
  print(site.getuserbase())
  

  部分场景下，Matplotlib会优先读取~/Library/Application Support/matplotlib目录的配置，可尝试将matplotlibrc移至该目录测试。

• 验证配置文件合法性
  若配置文件存在语法错误，Matplotlib会自动忽略并 fallback 到默认配置。直接将工作目录中可正常生效的配置文件复制到~/.config/matplotlib，排除内容格式问题。

• 清理缓存并强制指定配置目录
  删除.matplotlib缓存后，强制指定配置目录再启动Python：

  rm -rf ~/.matplotlib
  export MPLCONFIGDIR=~/.config/matplotlib
  

  之后进入Python重新执行matplotlib.matplotlib_fname()查看结果。

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