在Jupyter Notebook中使用Plotly绘制美国地图时调用go.Figure报错

以下是几种常见的报错原因及对应解决方法：

• data或layout变量格式错误
  确保data是正确的Plotly地理轨迹对象（比如go.Choropleth），且必填参数完整。绘制美国地图时，必须指定locationmode='USA-states'，同时geo布局要设置scope='usa'。示例正确代码：

  import plotly.graph_objects as go
  
  # 构造正确的地理数据轨迹
  data = go.Choropleth(
      locationmode='USA-states',
      locations=['NY', 'CA', 'TX'],  # 美国州缩写
      z=[15, 30, 22],  # 对应州的数据
      colorscale='Blues'
  )
  
  # 构造符合要求的布局
  layout = go.Layout(
      title='美国各州数据可视化',
      geo=dict(scope='usa')  # 限定地图范围为美国
  )
  
  choromap2 = go.Figure(data=[data], layout=layout)
  choromap2.show()
  

• Plotly版本兼容问题
  旧版本Plotly可能对地理图形的参数支持不完善，直接升级到最新稳定版即可：

  pip install --upgrade plotly
  

  若使用conda环境：

  conda update plotly
  

• Jupyter渲染器配置问题
  部分Jupyter环境需要手动指定Plotly渲染器，在代码开头添加以下配置：

  import plotly.io as pio
  pio.renderers.default = 'notebook'  # Jupyter Notebook用这个，JupyterLab可改为'jupyterlab'
  

• 变量名冲突
  检查data或layout是否被其他代码覆盖成了非Plotly对象（比如被赋值为普通列表/字典），重命名变量或重新定义即可。

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