Plotly Express choropleth地图在VS Code Jupyter中不显示如何解决

核心原因 #

• VS Code 内置Jupyter渲染器的兼容性限制：choropleth地图属于需要加载地理底图资源的交互式图表，VS Code默认的Plotly渲染逻辑对这类复杂交互式图表的支持度低于Anaconda原生Jupyter，容易出现资源加载失败的问题。
• 运行内核不匹配：VS Code Jupyter选择的Python内核与Anaconda中正常运行的环境不一致，对应环境的Plotly、ipywidgets等依赖版本过低，缺少地理渲染所需的组件。
• 离线资源加载权限限制：VS Code的内置网页渲染环境默认限制部分本地离线资源的调用，Plotly内置的地理边界JSON资源无法正常读取导致底图无法显示。
• 代码逻辑错误：你提供的示例代码中存在基础错误，df = "//location.csv"是将字符串直接赋值给df，并没有读取CSV文件，也会导致图表生成失败。

可行解决方案 #

首先请修正代码的基础逻辑错误，将df赋值语句替换为df = pd.read_csv("//location.csv")，确认代码本身可正常生成图表对象后再执行以下排查：

• 主动指定Plotly渲染器：在fig.show()前新增渲染器配置代码，适配VS Code环境：

import plotly.io as pio
# 选择以下任意一种适配的渲染器即可
pio.renderers.default = "notebook_connected"
# pio.renderers.default = "iframe"
# pio.renderers.default = "colab"

• 升级相关依赖：在当前VS Code使用的Python内核下执行升级命令：
  pip install --upgrade plotly ipywidgets jupyter-dash
  同时更新VS Code的Jupyter、Python扩展到最新版本。
• 核对运行内核：点击VS Code Jupyter右上角的内核选择按钮，确认选中的是和Anaconda中正常运行的同一个Python环境，避免多环境依赖差异问题。
• 导出为HTML文件打开：如果内置渲染始终异常，可以直接将图表导出为本地HTML文件调用浏览器打开：

fig.write_html("location_choropleth.html", auto_open=True)

内容的提问来源于stack exchange，提问作者WF30