Pyecharts中Sankey图边标签数值显示问题解析

在使用Pyecharts绘制Sankey图时，开发者经常会遇到边标签(EdgeLabel)无法正确显示数值的问题。本文将深入分析这一常见问题的原因，并提供完整的解决方案。

问题现象

当开发者尝试在Sankey图的边上显示具体数值时，使用{c}作为formatter参数，结果却显示为"undefined"。这与Echarts官方文档中描述的{c}应该显示数值的行为不符。

根本原因

经过分析，这个问题通常由以下两个因素导致：

1. Pyecharts版本差异：不同版本的Pyecharts对Sankey图的参数处理方式有所不同
2. 参数冲突：当同时设置了label_opts和edge_label_opt时，可能会出现参数覆盖现象

解决方案

正确的实现方式应该是：

edge_label_opt=opts.LabelOpts(is_show=True)

完整示例代码如下：

nodes = [
    {"name": "category1"},
    {"name": "category2"},
    {"name": "category3"},
    {"name": "category4"},
    {"name": "category5"},
    {"name": "category6"},
]

links = [
    {"source": "category1", "target": "category2", "value": 10},
    {"source": "category2", "target": "category3", "value": 15},
    {"source": "category3", "target": "category4", "value": 20},
    {"source": "category5", "target": "category6", "value": 25},
]

c = (
    Sankey()
    .add(
        "sankey",
        nodes,
        links,
        edge_label_opt=opts.LabelOpts(is_show=True),
        linestyle_opt=opts.LineStyleOpts(opacity=0.2, curve=0.5, color="source"),
        label_opts=opts.LabelOpts(position="right"),
    )
    .set_global_opts(title_opts=opts.TitleOpts(title="Sankey示例"))
)

注意事项

1. 避免在label_opts中设置formatter参数，这可能会覆盖边标签的显示设置
2. 确保Pyecharts版本在2.0.4以上，以获得最佳兼容性
3. 如果确实需要自定义标签格式，可以使用JsCode回调函数实现更复杂的显示逻辑

总结

Pyecharts的Sankey图功能强大，但在使用边标签显示数值时需要注意参数的正确配置。通过本文提供的解决方案，开发者可以轻松实现边标签数值的显示，从而创建更加信息丰富的可视化图表。