Plotly桑基图标签缺失问题：为何几乎所有标签不显示？

安全阿岳

2026-7-21

Plotly桑基图标签缺失的排查方向

检查nodes的label字段完整性
Plotly桑基图要求nodes数组必须包含label键，且每个label不能是空值、NaN或者重复值。如果有节点的label为空，或者多个节点共用同一个label，就会出现标签不显示或覆盖的情况。
确认from/to字段是nodes的索引值
automotive_from_to里的from和to必须是对应nodes数组的0起始整数索引，不能直接用节点名称。如果你的from/to存的是节点名称，得先做映射：把nodes里的label和索引对应起来，再把from/to替换成对应的索引值。
校验数据类型
确保from、to字段是整数类型，不是字符串或其他类型。Plotly只会识别整数索引，字符串类型的索引会导致节点无法关联标签。
检查索引范围是否合法
查看automotive_from_to中from/to的最大值，必须小于nodes数组的长度。如果索引超出了nodes的范围，对应的节点会被Plotly忽略，标签自然不会显示。
排查Plotly版本与布局参数
旧版本Plotly可能存在桑基图标签显示的bug，建议更新到最新稳定版。另外检查布局设置，比如layout.sankey.node.label.font是否被设置为不可见，或者node.pad值太小导致标签被节点图形挤压隐藏。