Quarto无法渲染含Python代码块的文档，R代码块可正常渲染求助

问题描述 #

Quarto可正常渲染包含R代码块的文档，但渲染包含Python代码块的文档时失败。

错误信息 #

执行渲染命令时收到如下错误：

==> quarto preview example.Qmd --to html --no-watch-inputs --no-browse

ERROR: Unable to render example.Qmd

Stack trace:
    at fileExecutionEngineAndTarget (file:///C:/PROGRA~1/Quarto/bin/quarto.js:41260:15)
    at async renderContexts (file:///C:/PROGRA~1/Quarto/bin/quarto.js:72183:32)
    at async renderFormats (file:///C:/PROGRA~1/Quarto/bin/quarto.js:72234:22)
    at async file:///C:/PROGRA~1/Quarto/bin/quarto.js:98062:24
    at async Command.fn (file:///C:/PROGRA~1/Quarto/bin/quarto.js:98059:25)
    at async Command.execute (file:///C:/PROGRA~1/Quarto/bin/quarto.js:8104:13)
    at async quarto (file:///C:/PROGRA~1/Quarto/bin/quarto.js:114968:5)
    at async file:///C:/PROGRA~1/Quarto/bin/quarto.js:114986:9

复现步骤 #

1. 执行以下CLI命令渲染桌面的example.Qmd文档：

quarto render Desktop\example.Qmd

2. example.Qmd内容（切换为R代码块时将python改为r即可正常渲染）：

---
title: Example
subtitle: Example
format: html
---

```{python}
2 + 2

## 环境配置
### 设备
Microsoft Windows 11 Home，版本10.0.22621 Build 22621

### 软件版本
以下路径均已添加至PATH环境变量：
- R 4.3.0（路径：`C:\Program Files\R\`）
- Python 3.12.1（路径：`C:\Program Files\Python312\`）
- Quarto 1.4.547（路径：`C:\Program Files\Quarto`）

### Jupyter配置
按Quarto官方指引执行`py -m pip install jupyter`完成安装，路径为`C:\Users\me\appdata\roaming\python\python312\site-packages`。执行`quarto check jupyter`返回结果正常：

Quarto 1.4.547
[>] Checking Python 3 installation....OK
Version: 3.12.1
Path: C:/Program Files/Python312/python.exe
Jupyter: 5.7.1
Kernels: python3

[>] Checking Jupyter engine render....OK

## 解决方案建议
- **验证Python内核注册**：执行`jupyter kernelspec list`，确认`python3`内核的路径指向你的Python 3.12.1安装目录。若路径不符，执行`python -m ipykernel install --user --name python3 --display-name "Python 3.12"`重新注册内核。
- **指定Jupyter解释器**：在Qmd的YAML头部添加`jupyter: python3`，或直接指定Python路径：`jupyter: "C:/Program Files/Python312/python.exe"`。
- **检查权限**：以管理员身份打开命令提示符，再执行渲染命令，避免权限不足导致无法访问资源。
- **更新依赖包**：执行`py -m pip install --upgrade jupyter ipykernel`，确保Jupyter和内核组件为最新版本。
- **单独测试Jupyter**：打开Jupyter Notebook，创建Python 3笔记本并运行`2+2`，确认Jupyter本身可正常执行代码。
- **检查Quarto配置**：执行`quarto config list`，查看`quarto.config.python.executable`项是否指向正确的Python路径，若有误可手动配置：`quarto config set python.executable "C:/Program Files/Python312/python.exe"`。

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