Windows 10下VS Code中Quarto渲染Python文档遇OS Error 1920求助

问题根源 #

报错指向的C:\Users\HP\AppData\Local\Microsoft\WindowsApps\python.exe是微软商店版Python的占位快捷方式，并非真实可执行文件，Quarto无法通过这个 stub 执行Python代码。

解决方案 #

1. 在Quarto文档中指定真实Python路径 #

找到你实际安装的Python可执行文件路径（比如从python.org下载的版本通常在C:\Users\HP\AppData\Local\Programs\Python\Python3x目录下，3x替换为你的具体版本号），然后在QMD文件的YAML头部添加执行配置：

---
title: "Quarto Basics"
format:
  html:
    code-fold: true
jupyter: python3
execute:
  python: "C:/Users/HP/AppData/Local/Programs/Python/Python311/python.exe"
---

或者直接在命令行中指定路径：

quarto preview c:/Users/HP/Desktop/trial/demo_1.qmd --no-browser --no-watch-inputs --execute-python="C:/Users/HP/AppData/Local/Programs/Python/Python311/python.exe"

2. 调整系统环境变量优先级 #

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在用户变量的Path列表中，找到C:\Users\HP\AppData\Local\Microsoft\WindowsApps，将其拖动到Python实际安装路径（如C:\Users\HP\AppData\Local\Programs\Python\Python311）的下方
• 确保Python的Scripts目录也在Path中（例如C:\Users\HP\AppData\Local\Programs\Python\Python311\Scripts）
• 重启VS Code和命令提示符，使环境变量生效

3. 卸载微软商店版Python #

• 打开Windows设置→「应用」→「应用和功能」
• 搜索「Python」，找到微软商店发布的版本并点击卸载
• 卸载后Quarto会自动识别系统中真实的Python安装路径

4. 使用Conda环境（若安装了Anaconda/Miniconda） #

• 激活目标Conda环境：

  conda activate your_env_name
  

• 在激活的环境中运行Quarto预览命令，此时会自动使用环境内的Python版本

验证 #

完成上述任一操作后，重新执行Quarto渲染命令，即可正常生成HTML文档。

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