matplotlib中文显示之图表的示例分析

发布时间：2021-10-14 17:10:16 作者：小新
来源：亿速云阅读：212

# matplotlib中文显示之图表的示例分析

## 引言

在数据可视化领域，matplotlib作为Python最流行的绘图库之一，被广泛应用于科研、商业分析和工程领域。然而，当图表中需要显示中文时，许多开发者会遇到中文显示为方框（乱码）的问题。本文将通过具体示例分析matplotlib中文显示的解决方案，并展示完整实现代码。

## 一、中文显示问题的根源

### 1.1 默认字体不支持中文
matplotlib默认使用英文字体（如'DejaVu Sans'），这些字体不包含中文字符集。当系统尝试渲染中文时，会因找不到对应字形而显示为方框。

### 1.2 跨平台兼容性问题
不同操作系统（Windows/macOS/Linux）的中文字体名称和存放路径存在差异，导致统一解决方案难以适配所有环境。

## 二、解决方案对比分析

### 2.1 临时指定中文字体（推荐）
```python
import matplotlib.pyplot as plt

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

plt.title("中文标题示例")
plt.plot([1,2,3], label="数据线")
plt.legend()
plt.show()

优点：

代码简洁
全局生效
跨平台可替换为其他字体（如’microsoft yahei’）

缺点：

需要预先知道系统可用字体

2.2 动态加载字体文件

from matplotlib.font_manager import FontProperties

font = FontProperties(fname='msyh.ttc', size=12)  # 指定字体文件路径

plt.title("动态加载字体示例", fontproperties=font)
plt.xlabel("X轴", fontproperties=font)

适用场景：

需要特殊字体（如书法字体）
字体不在系统默认路径

2.3 操作系统适配方案

import platform

system = platform.system()
if system == 'Windows':
    plt.rcParams['font.sans-serif'] = ['Microsoft YaHei']
elif system == 'Darwin':
    plt.rcParams['font.sans-serif'] = ['PingFang SC']
else:
    plt.rcParams['font.sans-serif'] = ['WenQuanYi Zen Hei']

三、完整示例分析

3.1 柱状图示例

import numpy as np

products = ["手机", "笔记本", "平板", "耳机"]
sales = [120, 85, 60, 45]

plt.bar(products, sales, color='#4c72b0')
plt.title("2023年产品销量统计", pad=20)
plt.xlabel("产品类别")
plt.ylabel("销量（万件）")
plt.grid(axis='y', linestyle='--')

3.2 饼图中文标注

sizes = [15, 30, 45, 10]
labels = ["北方", "华东", "华南", "西部"]

plt.pie(sizes, labels=labels, autopct='%1.1f%%',
        textprops={'fontsize': 12})
plt.axis('equal')
plt.title("区域销售占比")

3.3 复杂图表综合应用

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5))

# 左图：折线图
months = ["1月", "2月", "3月", "4月"]
ax1.plot(months, [20, 25, 18, 30], marker='o')
ax1.set_title("季度趋势")

# 右图：散点图
np.random.seed(42)
x = np.random.rand(50)
y = x + np.random.normal(0, 0.1, 50)
ax2.scatter(x, y)
ax2.set_title("数据分布")

plt.suptitle("复合图表分析", y=1.05)
plt.tight_layout()

四、进阶技巧

4.1 字体属性精细控制

font_dict = {
    'family': 'SimSun',
    'weight': 'bold',
    'size': 14,
    'color': '#d62728'
}

plt.text(0.5, 0.5, "自定义样式文本", 
         fontdict=font_dict, 
         ha='center')

4.2 多语言混排

plt.title("中文Chinese混合显示")

4.3 字体缓存问题处理

当修改字体后未生效时，可清除缓存：

rm ~/.matplotlib/fontlist-v330.json

五、常见问题排查

字体列表查询：

from matplotlib.font_manager import fontManager
print([f.name for f in fontManager.ttflist if 'hei' in f.name.lower()])

错误排查步骤：
- 确认字体名称拼写正确
- 检查字体是否实际存在
- 尝试绝对路径指定字体文件
Web环境注意事项：在Jupyter等环境中可能需要额外配置：

%matplotlib inline
from IPython.display import set_matplotlib_formats
set_matplotlib_formats('retina')

结语

通过本文的示例分析可以看出，解决matplotlib中文显示问题需要根据具体场景选择合适方案。推荐开发者建立自己的字体管理工具函数，并在项目初期就做好中文兼容性测试。随着matplotlib的版本更新（当前稳定版3.6+），中文支持也在不断改进，建议保持库版本为最新状态以获得最佳体验。

注：本文所有代码示例在Python 3.8+和matplotlib 3.5+环境下测试通过 “`