如何在Matplotlib中为Butt端点样式的线条添加边框？

这确实是matplotlib.patheffects.withStroke处理butt端点样式时的一个常见小坑，我来帮你拆解原因并给出简洁的解决思路：

问题根源 #

当你使用solid_capstyle="butt"时，原始线条的路径在端点处是平切且无延伸的。withStroke的原理是生成原始路径的轮廓路径并填充，而butt路径的轮廓在端点处是开放的，所以描边无法形成完整的封闭边框；而默认的projecting端点样式会让路径在两端延伸出线条宽度的一半，轮廓自然是封闭的，因此描边能完美包裹线条。

直接在withStroke里设置capstyle="projecting"会导致描边的端点过度延伸，看起来两端过粗，这显然不是我们想要的效果。

优雅解决方案：图层叠加法 #

我们可以通过叠加两层线条来实现需求：

1. 底层先绘制带projecting端点样式的描边，让描边形成完整的封闭轮廓；
2. 顶层再绘制butt端点样式的主线条，覆盖住描边超出的延伸部分，只保留描边的侧面和两端的垂直封边。

这样视觉上就呈现出butt线条带有完整描边的效果，完全不需要手动绘制补全线段。

修改后的代码示例 #

import matplotlib.pyplot as plt
import matplotlib.patheffects as pe

# 定义描边效果，使用projecting cap让轮廓封闭
outline = pe.withStroke(linewidth=8, foreground='black', solid_capstyle="projecting")

plt.figure(figsize=(8, 6))

# 无透明度的带描边butt线条
plt.plot([1,2], [1,1], lw=5, color='red', path_effects=[outline], solid_capstyle="projecting")
plt.plot([1,2], [1,1], lw=5, color='red', solid_capstyle="butt", label="stroke no alpha")

# 带透明度的带描边butt线条
plt.plot([1,2], [2,2], lw=5, color='red', path_effects=[outline], solid_capstyle="projecting")
plt.plot([1,2], [2,2], lw=5, alpha=0.5, color='red', solid_capstyle="butt", label="stroke with alpha")

# 对照组：无描边带透明度的butt线条
plt.plot([1,2], [3,3], lw=5, alpha=0.5, color='red', solid_capstyle="butt", label="no stroke with alpha")

plt.legend(bbox_to_anchor=(1, 1.02), loc='upper left')
plt.show()

额外说明 #

如果需要更精细化的控制（比如自定义描边的端点形状），也可以通过继承matplotlib.patheffects.PathEffect来实现自定义路径处理，但对于绝大多数场景，上述图层叠加的方法已经足够简洁高效，完全能满足你的需求。

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