mpld3生成无法JSON序列化的axes属性，散点图HTML渲染问题求助

先来说你遇到的edgewidths序列化问题——这个坑我之前也踩过，本质是matplotlib散点图返回的PathCollection对象里的edgewidths属性是numpy数组，而mpld3在转换为字典时没有自动把numpy数组转成Python原生类型，导致json.dumps无法处理。下面给你几个具体的解决办法：

一、直接修改散点图的edgewidths属性 #

你不需要修改axes的属性，而是要找到散点图对应的对象，把它的edgewidths改成Python原生列表：

方法1：绘图时直接设置为列表 #

在调用ax.scatter()的时候，把edgewidths参数设为Python列表（而不是numpy数组）：

import matplotlib.pyplot as plt
import mpld3
import numpy as np

fig, ax = plt.subplots()
# 这里用[1]代替np.array([1])
ax.scatter(np.random.rand(50), np.random.rand(50), edgewidths=[1])

# 直接生成HTML即可，不用手动处理字典
html_str = mpld3.fig_to_html(fig)
with open('scatter.html', 'w') as f:
    f.write(html_str)

方法2：绘图后修改已有的散点对象 #

如果已经用numpy数组设置了edgewidths，可以事后转换：

scatter = ax.scatter(..., edgewidths=np.array([1]))
# 把numpy数组转成Python列表
scatter.set_edgewidths(scatter.get_edgewidths().tolist())

方法3：给json.dumps加numpy类型处理器 #

如果不想修改绘图代码，可以在序列化字典时，给json.dumps传一个default函数来处理numpy类型：

import json

fig_dict = mpld3.fig_to_dict(fig)
# 处理numpy数组和数值类型
def serialize_numpy(obj):
    if isinstance(obj, np.ndarray):
        return obj.tolist()
    if isinstance(obj, np.generic):
        return obj.item()
    raise TypeError(f"无法序列化类型: {type(obj)}")

json_str = json.dumps(fig_dict, default=serialize_numpy)

二、关于mpld3是不是HTML渲染的最佳后端 #

这个得看你的需求：

• 如果只是想快速把现有matplotlib代码转成HTML，不需要复杂交互，mpld3是个不错的选择——它完全兼容matplotlib语法，几乎不需要改代码就能生成HTML。但它的缺点是对一些matplotlib高级属性支持不好，交互功能也比较有限。
• 如果需要强交互性（比如缩放、悬停详情、点击事件、动态更新），更推荐用Plotly或者Bokeh：这两个库专门针对交互式可视化设计，生成的HTML交互体验更好，文档和社区支持也更完善。比如Plotly可以直接把matplotlib对象转成Plotly图表，再导出HTML，代码改动也不大。
• 如果只需要静态HTML图表，也可以试试matplotlib自带的plt.savefig()，指定format='html'（需要确保安装了对应的依赖，比如matplotlib-backend-html5canvas），不过灵活性不如专门的库。

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