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

问题背景

在使用Pyecharts绘制Sankey图(桑基图)时，开发者经常需要在图的边上显示具体的数值。Sankey图是一种特殊类型的流图，用于展示流量、能量或资源的流动情况，边上的数值对于理解数据流动的规模至关重要。

问题现象

在Pyecharts 2.0.4版本中，开发者尝试通过edge_label_opt参数的formatter属性来显示边的数值时，遇到了以下问题：

1. 按照ECharts(JS版)的文档，使用{c}作为格式化字符串应该显示边的数值
2. 但在Pyecharts中，使用{c}却显示为"undefined"
3. 同时，在tooltip中却能正常显示数值

问题原因

经过分析，这个问题主要由以下原因导致：

1. 格式化字符串冲突：当同时在label_opts和edge_label_opt中设置格式化字符串时，可能会产生冲突
2. 默认行为差异：Pyecharts的Sankey图实现与原生ECharts在某些默认行为上存在差异
3. 参数优先级问题：不同标签选项参数的优先级可能影响最终显示效果

解决方案

正确的实现方式如下：

from pyecharts import options as opts
from pyecharts.charts import Sankey

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},
]

sankey = (
    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图示例"))
)

sankey.render("sankey_example.html")

关键点说明：

1. 简化配置：不需要显式设置formatter参数，使用默认配置即可显示数值
2. 避免冲突：不要在label_opts中设置格式化字符串
3. 明确显示：确保edge_label_opt中的is_show参数设置为True

深入理解

为了更好地理解这个问题，我们需要了解Pyecharts中Sankey图的标签显示机制：

1. 数据绑定：Sankey图的边数值实际上绑定在links数据的"value"字段上
2. 自动映射：Pyecharts会自动将value值映射到边的标签上
3. 格式化优先级：当不指定formatter时，系统会使用默认的数值显示方式

最佳实践

基于此问题的分析，建议在使用Pyecharts绘制Sankey图时：

1. 优先使用默认配置：对于简单的数值显示需求，优先不设置formatter
2. 分步调试：如果遇到显示问题，先简化配置，再逐步添加复杂选项
3. 版本注意：不同版本的Pyecharts可能有不同的默认行为，注意检查版本兼容性

总结

Pyecharts中的Sankey图边标签数值显示问题通常源于配置冲突或过度定制。通过简化配置，使用默认行为，可以轻松实现边的数值显示。这一问题的解决不仅适用于当前案例，也为处理Pyecharts中其他类似的可视化问题提供了思路。