Azure Data Studio Notebook运行shap.initjs()失败无法渲染SHAP可视化

数据老陈

2026-10-2

问题根因

Azure Data Studio (ADS) 的 Notebook 内核默认启用了JavaScript资源注入限制，shap.initjs() 的核心作用是向当前页面注入SHAP可视化依赖的JS库，该操作被ADS的安全策略拦截，因此会触发JS库未加载的报错，可视化无法正常渲染。

可落地修复方案

方案1：改用matplotlib静态渲染（无需依赖JS，最便捷）
无需调用shap.initjs()，在生成force_plot时传入matplotlib=True参数，直接渲染为静态图片输出，修改后的代码如下：

import matplotlib.pyplot as plt
test_sample = test_x.iloc[:2000,:]
shap_values_sample = explainer.shap_values(test_sample)
shap.force_plot(explainer.expected_value[1], shap_values_sample[1], test_sample, link="logit", matplotlib=True)
plt.show()

方案2：导出为HTML文件保留交互能力
如果需要使用SHAP可视化的交互功能，可将生成的force_plot对象保存为本地HTML文件，后续直接用浏览器打开该文件即可正常使用所有交互效果，代码示例如下：
```
test_sample = test_x.iloc[:2000,:]
shap_values_sample = explainer.shap_values(test_sample)
force_plot = shap.force_plot(explainer.expected_value[1], shap_values_sample[1], test_sample, link="logit")
shap.save_html("shap_force_plot.html", force_plot)
```
运行完成后到你指定的存储路径找到shap_force_plot.html，用任意浏览器打开即可查看交互式可视化结果。