当使用 `matplotlib` 绘制柱状图并在柱子上方添加文字标签（如数值或比例）时，**文字显示重叠**是一个常见问题，尤其是在柱子较多或文字较长的情况下。 --- ### ❓ 为什么会出现文字重叠？ 常见原因包括： - 柱子太多，标签密集； - 标签内容太长（如数值 + 百分比）； - 图表尺寸太小，没有足够空间； - 标签位置设置不当； - 没有使用自动布局调整功能。 --- ### ✅ 解决方法汇总 --- #### 1. **增加图表宽度（figsize）** ```python fig, ax = plt.subplots(figsize=(10, 6)) # 增加宽度 ``` --- #### 2. **旋转 x 轴标签（适用于柱子太多的情况）** ```python plt.xticks(rotation=45, ha='right') # 向右对齐 + 旋转 ``` --- #### 3. **调整标签位置，错开显示** 可以将标签分别放在柱子的上方、内部或侧面，避免堆叠。 ```python for i, bar in enumerate(bars): height = bar.get_height() ax.text( bar.get_x() + bar.get_width() / 2, height + (i % 2) * 3, # 奇偶错开显示 f'{height}', ha='center', va='bottom' ) ``` --- #### 4. **使用 `adjustText` 库自动避让** 这是一个第三方库 `adjustText`，可以智能调整文本位置，避免重叠。 ```bash pip install adjustText ``` ```python from adjustText import adjust_text texts = [] for bar in bars: height = bar.get_height() texts.append( ax.text( bar.get_x() + bar.get_width() / 2, height, f'{height}', ha='center' ) ) adjust_text(texts, autoalign='y', expand_text=(1.2, 1.2), force_text=(0.5, 0.5)) ``` --- #### 5. **减少标签内容或换行显示** 如果标签是 `数值 + 百分比`，可以考虑只显示一个，或换行显示。 ```python ax.text(..., f'{height}\n({percentage:.1f}%)', ...) # 换行显示 ``` --- #### 6. **使用 `plt.tight_layout()` 或 `constrained_layout`** ```python fig, ax = plt.subplots(constrained_layout=True) # 或者 plt.tight_layout() ``` --- ### ✅ 示例：解决文字重叠的完整代码 ```python import matplotlib.pyplot as plt from adjustText import adjust_text labels = [f'Label {i}' for i in range(1, 11)] values = [10, 15, 7, 12, 9, 14, 18, 13, 8, 16] fig, ax = plt.subplots(figsize=(12, 6)) bars = ax.bar(labels, values) texts = [] for bar in bars: height = bar.get_height() texts.append( ax.text( bar.get_x() + bar.get_width() / 2, height * 1.02, f'{height}', ha='center', fontsize=10 ) ) adjust_text(texts, autoalign='y', expand_text=(1.2, 1.2), force_text=(0.5, 0.5)) plt.ylim(0, max(values) * 1.2) plt.xticks(rotation=45, ha='right') plt.tight_layout() plt.title('柱状图：解决文字重叠') plt.show() ``` --- ### ✅ 总结 | 方法 | 用途 | |------|------| | 增大图表尺寸 | 提供更多空间 | | 旋转 x 轴标签 | 避免柱子太密 | | 调整标签位置 | 错开显示避免重叠 | | 使用 `adjustText` | 自动避让重叠文本 | | 换行显示或简化内容 | 减少单个标签长度 | | 自动布局调整 | 防止被裁剪或重叠 | ---