plotly.graph_objects.sankey是python中绘制桑基图最稳定可控的选择，需将原始会话路径聚合为“源→目标”频次表，手动排序节点、映射整数索引，并处理长路径截断与语义统一。
用 plotly.graph_objects 绘制桑基图最直接
桑基图在 Python 中没有原生支持的“一行代码”方案，plotly.graph_objects.Sankey 是目前最稳定、可控性最强的选择。它不依赖外部数据格式转换，直接接收节点名、链接索引和数值，适合从用户行为日志中提取的路径序列。
常见错误是试图把原始会话数据（如 ['home', 'search', 'product', 'cart']）直接喂给 Sankey —— 它不接受字符串路径列表，必须先聚合为「源→目标」频次表。
- 先用
pandas.DataFrame.shift()生成相邻步骤对：df['from'] = df['page'].shift(1)，df['to'] = df['page'] - 按
from和to分组计数，得到三列：源节点名、目标节点名、权重（即跳转次数） - 所有唯一节点名合并去重后传给
node['label']，源/目标需映射为整数索引传给link['source']和link['target']
节点顺序错乱会导致连线交叉或断裂
Sankey 不自动排序节点，node['label'] 的顺序决定了纵轴位置。如果用户路径有明确阶段（如曝光→点击→下单→支付），必须手动按业务逻辑排列节点顺序，否则图中连线会横跨整个画布，失去路径流向意义。
例如，若 node['label'] = ['pay', 'click', 'view']，即使数据中 view → click → pay 是主路径，绘图时也会显示为从底部 pay 指向上方 view，视觉上完全颠倒。
- 构建
node_labels时，显式按用户漏斗阶段排序：['landing', 'list', 'detail', 'cart', 'order', 'pay'] - 用
pd.Categorical或dict(zip(...))确保每个from/to字符串能映射到正确整数索引 - 检查
link['source']和link['target']值是否全部落在0到len(node_labels)-1范围内，越界会静默失败或报ValueError: Invalid value of type 'builtins.int'
长路径需截断或折叠，否则节点爆炸
真实用户行为常包含几十步（如反复刷新、跳转外链、埋点异常），全量展开会导致节点数激增，Sankey 渲染卡顿甚至崩溃，且无法阅读。不能靠增大画布解决，必须前置聚合。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
典型表现是图中出现大量孤立节点或极细连线，占满画布却看不出主路径。这不是绘图参数问题，而是数据建模问题。
- 限制单一会话最大步长：
df.groupby('session_id').head(8)，保留前 8 步（首页、列表、详情、加购、结算、支付、成功、分享） - 将低频动作合并为「其他」：
df['page'] = df['page'].apply(lambda x: x if x in top5_pages else 'other') - 对连续重复动作去重：
df = df.loc[df['page'] != df['page'].shift()]，避免「详情页→详情页→详情页」产生冗余边
hover 文本和颜色需手动绑定，plotly 默认不显示路径权重
Sankey 的 link['value'] 只控制线宽，不自动出现在悬停提示中。用户常误以为鼠标移上去就能看到“从 A 到 B 有多少人”，实际默认只显示节点名。必须显式配置 link['hovertemplate']。
另外，node 和 link 的颜色独立设置，不联动。若想让「搜索→商品页」这条边和「商品页」节点同色，得分别指定 node['color'] 和 link['color']，且索引要对齐。
- 设置
link['hovertemplate'] = 'From: %{source.label}<br>To: %{target.label}<br>Count: %{value}<extra></extra>' -
node['color']推荐用十六进制列表，长度等于node['label']；link['color']若未指定，会继承源节点色，但不可靠，建议显式赋值 - 若使用
plotly.express，它不支持 Sankey，别浪费时间找px.sankey()—— 不存在
桑基图真正的难点不在绘图语法，而在把杂乱的原始行为日志对齐到可解释的业务阶段，并确保每个节点名在全量数据中语义唯一。一个 'home' 可能对应 H5 首页、小程序首页、APP 启动页，混在一起画出来的图毫无分析价值。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
