VSCode Jupyter Notebook输出MIME类型来源及全局配置求助

MIME类型来源说明 #

第一个文件显示的text/html、text/plain是Jupyter内核返回的标准输出MIME类型，由VS Code Jupyter扩展内置的通用渲染器支持。第二个文件出现的application/vnd.somemorewords这类特殊MIME类型，通常是两种情况导致：

• 代码调用了第三方库（如小众可视化工具、自定义输出插件），主动生成了非标准MIME格式的输出；
• Notebook文件的outputs元数据中，持久化保存了之前运行代码产生的自定义输出结果。

标准MIME类型的读取逻辑 #

你看到的标准MIME类型，读取路径是：

1. 内核返回结果：Python等Jupyter内核执行代码后，会将输出按text/plain、text/html这类标准MIME格式打包返回；
2. 扩展内置配置：VS Code Jupyter扩展默认内置了这些标准MIME类型的渲染规则，相关定义在扩展的内部package.json的contributes.notebookRenderer字段中（全局设置无法直接修改内置映射）；
3. 用户设置补充：若未修改settings.json中的notebook.output.textMimetypes等配置，就会使用扩展默认的标准MIME列表。

解决MIME类型不一致的实操步骤 #

• 清理Notebook元数据：用文本编辑器打开异常的.ipynb文件，找到cells下的outputs节点，删除包含自定义MIME类型的输出项，保存后重新打开；
• 重置Jupyter扩展配置：在VS Code命令面板执行Preferences: Reset Settings，选择重置Jupyter相关设置，恢复扩展默认的MIME渲染规则；
• 排查第三方库影响：检查第二个Notebook中是否引入特殊库，暂时注释相关代码后重新运行，观察MIME类型是否恢复；
• 清理工作区设置：查看工作区的.vscode/settings.json，删除所有和notebook.renderers、notebook.output.mimetypes相关的自定义配置，避免局部设置覆盖全局默认。

如果需要强制统一标准MIME类型的显示优先级，可在全局settings.json中添加：

"notebook.output.textMimetypes": [
    "text/plain",
    "text/html"
],
"notebook.renderers.order": [
    "vscode.notebook-renderer.plaintext",
    "vscode.notebook-renderer.html"
]

注：该配置仅调整标准MIME类型的显示优先级，无法屏蔽第三方库生成的自定义MIME类型。

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