Quarto Dashboard调用Shiny报错：虚拟环境未被识别问题求助

一、外部终端执行quarto preview提示缺少shiny包 #

可能原因 #

VS Code快捷键执行时自动关联了安装shiny的R环境，但外部终端激活虚拟环境后，Quarto未正确识别到该R环境（shiny为R包，需确保Quarto调用的R路径对应已安装shiny的环境）。

解决办法 #

1. 验证当前终端的R环境：
   执行命令：

   Rscript -e "library(shiny)"
   

   若报错，说明当前R环境未安装shiny，需在目标虚拟环境（如renv、conda R环境）中重新安装shiny。

2. 临时指定R路径运行：
   在终端执行Quarto命令时，通过--r-path参数指定安装了shiny的R环境路径：

   quarto preview test.qmd --r-path /path/to/your/virtual/env/R
   

3. 全局配置Quarto的R路径：
   在项目根目录创建_quarto.yml文件，添加以下配置：

   execute:
     r:
       path: /path/to/your/virtual/env/R
   

   后续Quarto会自动使用该路径下的R环境，无需每次指定参数。

二、QUARTO_PYTHON环境变量在QMD代码块中设置无效 #

核心原因 #

环境变量需要在Quarto进程启动前加载，而QMD中的setup代码块是Quarto启动后执行的，此时设置环境变量无法生效。

解决办法 #

1. 永久设置环境变量：

   • Linux/macOS：编辑终端配置文件（如~/.bashrc、~/.zshrc），添加：

     export QUARTO_PYTHON=/path/to/your/python
     

     执行source ~/.bashrc（对应你的配置文件）使设置生效。
   • Windows：打开系统环境变量设置，新增QUARTO_PYTHON变量，值为目标Python的完整路径。

2. 临时单次设置：
   在执行Quarto命令前先设置环境变量：

   • Linux/macOS：

     QUARTO_PYTHON=/path/to/your/python quarto check jupyter
     

   • Windows（PowerShell）：

     $env:QUARTO_PYTHON = "C:\path\to\your\python"; quarto check jupyter
     

3. 通过Quarto配置文件指定：
   在项目根目录的_quarto.yml中添加Python路径配置：

   execute:
     python:
       path: /path/to/your/python
   

   此配置会被Quarto自动读取，无需手动设置环境变量。

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