VS Code运行.qmd单元格正常渲染时提示Numpy not found怎么办

AI 小北

2026-8-30

问题描述

使用.qmd格式文件编写Python代码时出现异常：在VS Code中单独运行代码单元格时numpy库可正常调用，但执行Notebook渲染操作时提示Numpy not found错误，对应错误截图如下：

触发原因

核心问题是两个操作调用的Python环境不一致：

VS Code中单独运行代码单元格时，调用的是你当前在VS Code工作区手动选中的Python解释器，这个环境里已经安装了numpy，所以运行无报错
Quarto渲染Notebook时不会自动继承VS Code选中的解释器，默认调用它自身绑定的系统Python路径，这个路径对应的环境没有安装numpy，就会触发找不到库的错误

修复方案

按以下优先级选择操作即可：

方案1：在qmd文件头部显式指定解释器
打开文件最开头的YAML配置段，添加jupyter配置项，填入你已经安装numpy的Python环境的绝对路径，示例配置：
```
---
title: "你的文档标题"
jupyter: "/home/xxx/miniconda3/envs/your_env/bin/python" # Linux/Mac路径格式，Windows替换为类似C:/Users/xxx/conda/envs/your_env/python.exe的路径
---
```
保存配置后重新执行渲染即可正常识别numpy。
方案2：给Quarto默认调用的Python环境安装numpy
打开系统终端执行quarto check jupyter，输出内容会明确显示Quarto当前绑定的Python路径，激活该路径对应的环境后，执行pip install numpy完成安装，再重新渲染即可。
方案3：统一VS Code中Quarto扩展的解释器配置
打开VS Code设置页，搜索Quarto Python Interpreter，将配置项的值修改为你平时运行代码使用的、已安装numpy的Python解释器完整路径，保存后重启VS Code再尝试渲染。