ValueError: Mime type rendering requires nbformat>=4.2.0

问题描述

在 Visual Studio Code 中使用 Plotly 绘制图表时，当调用 fig.show() 方法时遇到了以下错误：

ValueError: Mime type rendering requires nbformat>=4.2.0 but it is not installed

这个错误通常发生在 Jupyter 环境（包括 VS Code 的内核）中，当尝试渲染 Plotly 图表时发现缺少必要依赖或依赖版本过低。

错误原因

Plotly 库在 Jupyter 环境中渲染图表需要 nbformat 包（版本 >= 4.2.0），当此包未安装或版本不满足要求时就会出现此错误。

即使通过 pip install nbformat 安装了该包，也可能因为以下原因导致问题未解决：

• 未重启内核
• 安装到了错误的环境
• 依赖冲突

解决方案

方法一：安装或更新 nbformat

pip

pip install --upgrade nbformat

Conda

conda install -c conda-forge nbformat

Jupyter Notebook

!pip install --upgrade nbformat

安装完成后必须重启内核才能生效。

方法二：安装完整 Jupyter 环境

如果仅安装 nbformat 不够，可以安装完整的 Jupyter 包：

pip

pip install jupyter

Conda

conda install jupyter

方法三：重新安装 ipykernel

有时重新安装 ipykernel 可以解决问题：

pip install --upgrade ipykernel

方法四：检查环境配置

确保你在正确的环境中安装包：

1. 查看当前环境：

conda info --envs

2. 激活目标环境：

conda activate your_env_name

3. 在激活的环境中安装所需包

重要提示

无论使用哪种方法，安装完成后必须重启内核才能生效。在 VS Code 中，可以通过点击右上角的重启按钮或使用快捷键完成此操作。

预防措施

为了避免类似问题，建议：

1. 使用虚拟环境管理项目依赖
2. 创建环境时一次性安装所有必要依赖：

conda create -n myenv python=3.9 jupyter plotly

3. 定期更新维护依赖版本

这些解决方案涵盖了大多数遇到此错误的情况，按照步骤操作应该能够解决在 VS Code 中使用 Plotly 时遇到的 nbformat 依赖问题。