VS Code渲染.qmd为HTML时nbformat模块缺失错误的解决方法

核心原因 #

Quarto渲染时调用的Python环境，不是你安装了nbformat的conda环境，导致依赖包无法被找到。

解决步骤 #

1. 确认conda环境中的nbformat已正确安装 #

• 打开命令行，激活你的目标conda环境：

  conda activate 你的环境名称
  

• 验证nbformat是否存在：
  • Windows：pip list | findstr nbformat
  • Mac/Linux：pip list | grep nbformat
    输出中应能看到nbformat及其对应版本号。

2. 在VS Code中指定Quarto使用的Python环境 #

方法一：通过VS Code状态栏切换

• 打开你的.qmd文件，点击VS Code左下角状态栏显示的Python版本（比如Python 3.9.6 64-bit）。
• 在弹出的列表中，选择你安装了nbformat的conda环境。
• 重新点击右上角的Render按钮或按Ctrl+Shift+K尝试渲染。

方法二：在.qmd文件头部指定内核

在文件最顶部的YAML配置块中，直接指定要使用的conda环境或Python路径：

---
title: "你的文档标题"
jupyter:
  # 方式1：指定conda环境的内核名称
  kernelspec:
    name: python3
    display_name: Python (你的conda环境名)
  # 方式2：直接指定环境的Python可执行文件路径
  # python: "D:\\conda\\envs\\你的环境名\\python.exe"
---

3. 用conda环境的命令行直接渲染 #

• 激活目标conda环境后，进入.qmd文件所在目录，执行：

  quarto render 你的文件名.qmd --to html
  

  这种方式会强制使用当前激活的conda环境的Python。

4. 全局配置Quarto的Python路径 #

如果希望所有Quarto项目默认使用该conda环境，可设置全局配置：

quarto config set jupyter.python "D:\\conda\\envs\\你的环境名\\python.exe"

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