RStudio渲染Quarto网站默认Python内核问题求助

云原生阿岚

2026-7-25

解决Quarto网站默认使用Python内核渲染的问题

问题重现

两台电脑均使用RStudio的R内核开发Quarto网站，但在另一台电脑重新打开项目后，渲染时默认调用Python内核，出现ModuleNotFoundError: No module named 'nbformat'及Jupyter未安装的报错。已尝试在.quarto.yml添加kernel: ir、重启RStudio等操作，未解决问题。

解决方案

检查单文档内核配置
打开项目中的.qmd文档，查看开头的YAML元数据块（---包裹的部分），如果存在jupyter: python3这类指定Python内核的配置，将其修改为jupyter: ir，或者直接删除该行，让项目级配置接管。
修正.quarto.yml的配置层级
确保kernel: ir配置在正确的节点下，正确的项目配置示例：
```
project:
  type: website
  execute:
    kernel: ir
```
之前若将kernel: ir放在文件顶部（不属于任何节点），Quarto无法识别该配置。
清除Quarto缓存
在RStudio的终端中执行以下命令，清除缓存的渲染配置：
```
quarto clean
```
执行完成后重新渲染网站，避免旧配置残留影响。
手动指定内核渲染一次
点击RStudio右上角「Render」按钮旁的下拉箭头，选择「Render Website...」，在弹出的窗口中手动选择R内核完成渲染，Quarto会记住此次选择作为后续默认设置。
验证R内核识别状态
在R控制台运行以下代码，检查Quarto对R内核的识别情况：
```
quarto::quarto_inspect()
```
查看输出中是否包含ir内核的相关信息，确认R内核可用。