supertree 是一款交互式决策树可视化工具，可以把 scikit-learn、XGBoost、LightGBM 等模型渲染成可缩放、可折叠、可追踪样本路径的动态树状图。本文带你完成 supertree 在 Google Colab、JupyterLab 与 VS Code 三大平台的部署，从一键安装到常见渲染故障排查，全程只需 3 步操作。

先认识 supertree：交互式决策树可视化是什么？

supertree 解决的是传统plot_tree的痛点：树一深就糊成一片、无法交互。它把每个节点做成信息卡片，支持缩放平移、节点折叠展开、深度动态调整、悬停查看样本分布、高亮单条样本的决策路径，还能在森林模型中逐棵切换、导出 SVG。

下面是 iris 数据集上的分类树渲染效果：

安装只有一行命令：

pip install supertree

依赖非常轻量（pandas、numpy、ipython、ipywidgets），声明于 pyproject.toml，这也是它几乎不会"装不上"的原因。

为什么 supertree 在三大平台都能稳定渲染？

理解原理，排障就简单了。show_tree()的渲染逻辑在 supertree/supertree.py：它把内联 CSS（supertree/js/style.css）、打包后的 JS（supertree/js/supertree.min.js）和树数据 JSON 直接拼成一段自包含 HTML，通过IPython.display注入单元格输出，见拼装逻辑 supertree/templatehtml.py。

一句话：没有外部服务器、没有额外前端依赖、没有 iframe。任何能渲染 Notebook HTML 输出的环境（Jupyter Notebook / JupyterLab / Colab / VS Code Notebook）都能稳定显示。

Google Colab：30秒完成 supertree 决策树可视化部署

第 1 步：新建 Notebook，在第一个单元格执行：

pip install supertree

第 2 步：训练模型。官方提供了 iris 分类树完整示例，核心就 5 行：

from supertree import SuperTree super_tree = SuperTree(model, iris.data, iris.target, iris.feature_names, iris.target_names) super_tree.show_tree()

第 3 步：运行该单元格，树直接出现在输出里。完整代码可参考 examples/MainExample.ipynb。

⚠️ 两点注意：

• Colab 运行时是临时的，重开会话后必须重新pip install supertree；
• 建议"训练 + 可视化"写在同一 Notebook。若只重跑输出单元格报NameError，多半是内核被重置，点菜单Runtime → Rerun all即可。

JupyterLab：本地环境部署 supertree 的最快方法

JupyterLab 的优势是环境持久，装一次长期有效。

第 1 步：建议用独立虚拟环境隔离依赖，避免与项目其他包版本冲突：

python -m venv .venv && source .venv/bin/activate pip install supertree

第 2 步：启动 JupyterLab 时指向这个环境（在激活的虚拟环境里执行jupyter lab，或在设置页选择对应内核）。

第 3 步：运行show_tree()。

📌 排障关键：如果页面出现内核报错（ModuleNotFoundError），九成是"内核用的 Python"和"装 supertree 的 Python"不是同一个。用!which python或查看内核名核对即可。

森林模型同理，用show_tree(2)指定树索引即可切换查看，随机森林的渲染效果如下：

supertree 随机森林可视化：森林模型中逐棵切换决策树

VS Code：在 Jupyter 内核中稳定渲染 supertree

VS Code 完全支持 ipywidgets 与 HTML 输出，但有一个前提：必须以 Notebook 模式打开.ipynb文件。

第 1 步：在项目文件夹中用 VS Code 打开文件，确认右上角编辑器类型是Jupyter Notebook（若显示为纯文本，右键文件 →Open With → Jupyter Notebook）。

第 2 步：通过右下角状态栏选择 Python 解释器，必须指向安装了 supertree 的那个环境（例如上文的.venv）。

第 3 步：运行单元格，输出即渲染完成。

💡 进阶：show_tree(widgets=True)可以启用基于 supertree/supertree.py 的 ipywidgets 交互控件（官方示例见 examples/IPyWidgetsExample.ipynb），但在 VS Code 中推荐直接用默认的show_tree()，内联 HTML 输出兼容性更稳。

渲染不稳定？对照这张故障排查表

start_depth与max_samples是"大模型稳定渲染"的两大旋钮，参数说明见 docs/python_docs.md。树比较深时动态调整深度非常直观：

🎁 小彩蛋：传入show_sample=[3]这样的参数，界面上会出现按钮，一键高亮第 3 条样本从根到叶的完整决策路径：

总结：supertree 多平台部署一步到位

1. 任意平台执行pip install supertree，依赖少、装得快；
2. 确认内核/解释器与依赖环境一致，这是三大平台共同的唯一硬性要求；
3. SuperTree(...)+show_tree()两行代码出图，大模型用start_depth/max_samples保稳定。

想进一步折腾，可以继续看官方示例目录 examples/ 下的 examples/GradientBoostExample.ipynb、examples/LightGBMAndXGBoostExample.ipynb，或从源码入口 supertree/supertree.py 入手理解渲染链路。