Squarify画不出真正带层级标签的树状图，因其仅计算矩形坐标，不支持父子关系、折叠展开或悬停提示；所谓“带标签”实为matplotlib临时添加的粗略文本，字体大小固定、无缩进与交互。
为什么 Squarify 画不出带标签的树状图？
Squarify 本身只负责计算矩形坐标，不负责渲染图形或添加文字标签。你调用 squarify.plot() 看到的“带标签”图，其实是它内部用 matplotlib 临时加的，但标签位置粗略、字体大小固定、不支持层级缩进或交互——这根本不是真正意义上的“树状图”，只是带面积编码的嵌套矩形图（即 treemap）。如果你需要展示父子关系、折叠展开、悬停提示，squarify 无法满足。
Plotly Treemap 怎么传入层级数据？
Plotly 的 px.treemap() 要求数据必须是“宽表扁平化”结构：每行代表一个叶子节点，用多个列分别表示各级父节点。不能直接传嵌套字典或 networkx 图对象。
- 假设你要表达 “中国 → 广东 → 深圳 → 南山区”，就得拆成四列：
level1、level2、level3、level4，对应值为"中国"、"广东"、"深圳"、"南山区" - 数值列（如
value）只能放在叶子节点；非叶子节点的值会被自动聚合（默认求和），所以父节点无需单独提供数值 - 如果某行在
level2有值但level3为空，Plotly 会把它当作 level2 的叶子节点，不会向上合并——空值（None或np.nan）必须显式写出，不能省略整列
示例数据结构：
import pandas as pd
df = pd.DataFrame([
{"region1": "A", "region2": "A1", "region3": "A1a", "value": 10},
{"region1": "A", "region2": "A1", "region3": "A1b", "value": 15},
{"region1": "A", "region2": "A2", "region3": None, "value": 20},
{"region1": "B", "region2": None, "region3": None, "value": 25},
])
再传给 px.treemap(df, path=["region1", "region2", "region3"], values="value") 才能正确建树。
立即学习“Python免费学习笔记（深入）”；
怎么让 Plotly Treemap 显示完整路径文本而非仅叶子名？
默认情况下，Plotly treemap 悬停时只显示当前节点名和数值，不显示完整层级路径。要显示“中国 / 广东 / 深圳”，必须手动构造一列用于显示的文本，再通过 hover_data 或自定义 hovertemplate 注入。
- 先用
df["full_path"] = df["region1"] + " / " + df["region2"].fillna("") + " / " + df["region3"].fillna("")拼接（注意fillna("")防止 NaN 中断） - 然后在绘图时指定：
hover_data=["full_path"]，或更精确地：hovertemplate="%{customdata[0]}<extra>%{value}</extra>"，并用custom_data=df[["full_path"]]传入 - 注意：如果某行
region2是None，拼接后会出现多余" / "，需用str.replace(" / / ", " / ").replace(" / ", "")清洗
层级缺失或重复 ID 会导致 treemap 崩溃吗？
会，而且报错非常不友好——通常卡在 JavaScript 渲染层，浏览器控制台抛出 Cannot read property 'length' of undefined 或直接白屏。根本原因不是 Python 报错，而是 Plotly JS 库对输入结构做了强假设：
- 所有非空的父级字段必须构成合法前缀链。例如，出现
region2="A1"但没有任何行的region1是对应父级，treemap 就无法定位根节点 - 同一层级中相同名称的节点，如果 value 不同，会被视为不同节点（允许）；但如果 name 相同且 parent 也相同，Plotly 会尝试合并，此时若 value 类型不一致（如字符串混数字），就会静默失败
- 最稳妥做法：用
pandas.crosstab()或递归遍历原始树结构，生成带唯一id和parent列的长表，再转成 path 格式，比手动拼列更可靠
真正麻烦的从来不是画出来，而是确保输入数据的层级契约被严格遵守——这点在文档里藏得很深，调试时得打开浏览器开发者工具看 network 和 console。
