linux 环境下matplotlib 画图时不支持中文解决方案

在 Linux 环境下解决 matplotlib 绘图中文显示异常(乱码/方框)的问题,可通过以下步骤配置中文字体支持:


完整解决方案

1. 安装中文字体(以 SimHei 为例)

bash 复制代码
# 下载 SimHei 字体到系统字体目录
sudo wget -O /usr/share/fonts/SimHei.ttf https://zihao-openmmlab.obs.cn-east-3.myhuaweicloud.com/20220716-mmclassification/dataset/SimHei.ttf

# 更新字体缓存
sudo fc-cache -fv

2. 修改 matplotlib 配置文件

bash 复制代码
# 定位 matplotlib 配置文件路径(通常在以下位置)
python -c "import matplotlib; print(matplotlib.matplotlib_fname())"

# 编辑配置文件(例如路径为 ~/.config/matplotlib/matplotlibrc)
nano ~/.config/matplotlib/matplotlibrc

在配置文件中修改或添加以下参数:

ini 复制代码
font.family         : sans-serif
font.sans-serif     : SimHei, DejaVu Sans, Bitstream Vera Sans, Lucida Grande, Verdana, Geneva, Lucid, Arial, Helvetica, Avant Garde, sans-serif
axes.unicode_minus  : False  # 解决负号显示异常

3. 清除 matplotlib 缓存

bash 复制代码
rm -rf ~/.cache/matplotlib

4. 代码中显式指定字体(推荐)

python 复制代码
import matplotlib.pyplot as plt

plt.rcParams['font.sans-serif'] = ['SimHei']  # 指定默认字体
plt.rcParams['axes.unicode_minus'] = False    # 解决负号显示问题

# 测试绘图
plt.plot([1, 2, 3], [4, 5, 6])
plt.title("中文标题测试")
plt.xlabel("X轴")
plt.ylabel("Y轴")
plt.show()

验证是否成功

bash 复制代码
# 检查 matplotlib 可用字体列表是否包含 SimHei
python -c "from matplotlib.font_manager import FontManager; print([f.name for f in FontManager().ttflist if 'SimHei' in f.name])"

若输出包含 SimHei,则配置成功。


常见问题排查

  1. 字体路径错误

    • 确保字体文件已正确复制到 /usr/share/fonts/~/.fonts/ 目录。
    • 执行 fc-list | grep SimHei 检查字体是否被系统识别。
  2. 缓存未更新

    • 删除 ~/.cache/matplotlib 并重启 Python 进程。
  3. 代码冲突

    • 避免在代码中重复设置 font.sans-serif 或在局部使用 fontproperties 参数覆盖全局配置。

通过以上步骤,可彻底解决 Linux 下 matplotlib 中文显示问题。若需其他字体(如宋体、楷体),方法同理,只需替换对应的字体文件即可。

相关推荐
SamDeepThinking5 小时前
在 Cursor IDE 中配置 SQLTools 连接 MySQL 数据库指南(Windows 11)
后端·ai编程·cursor
武子康5 小时前
大数据-92 Spark 深入解析 Spark Standalone 模式:组件构成、提交流程与性能优化
大数据·后端·spark
青梅主码5 小时前
麦肯锡最新发布报告《想打破生产力天花板吗?重新思考完成工作的方式》:与其一味调整组织结构,不如从根本上简化工作流程,释放更大价值
后端
Python私教5 小时前
源滚滚Rust全栈班v1.02 无符号整数详解
开发语言·后端·rust
绝无仅有5 小时前
面试总结之Nginx 经验常见问题汇总第二篇
后端·面试·github
这里有鱼汤5 小时前
分享7种常见的量化交易策略
后端
绝无仅有6 小时前
面试实战总结之Nginx配置经验第一篇
后端·面试·github
shark_chili6 小时前
CPU性能优化三剑客:分支预测、并行运算与超线程技术深度解析
后端
小蒜学长6 小时前
基于Spring Boot的火灾报警系统的设计与实现(代码+数据库+LW)
java·数据库·spring boot·后端
Victor3566 小时前
Redis(53)如何优化Redis的性能?
后端