Quarto渲染qmd为HTML时环境变量加载失败的解决方法

核心原因 #

你遇到的问题本质是Quarto渲染进程没有继承到source .env加载的环境变量。尽管当前Shell会话里变量已存在，但如果Quarto是作为独立子进程启动（比如VS Code扩展单独拉起的进程），或者没有在同一条命令链中加载.env，就无法获取这些变量。

可行解决方案 #

1. 命令链中直接加载.env并执行Quarto #

将加载.env和Quarto命令放在同一条命令里，确保Quarto进程直接继承环境变量：

source .env && quarto preview "my-file.qmd" --to html --no-browser --no-watch-inputs

2. 在Python代码中直接读取.env文件（推荐） #

不依赖Shell环境，用python-dotenv包在代码里加载.env，稳定性更强：

• 先安装依赖：

  pip install python-dotenv
  

• 在.qmd的首个代码单元格添加加载逻辑：

  from dotenv import load_dotenv
  import os
  
  # 加载当前目录下的.env文件
  load_dotenv()
  # 正常获取变量
  variable = os.getenv('variable')
  

3. 确保VS Code继承Shell环境变量 #

如果使用VS Code扩展渲染，可能是VS Code没有继承终端的环境变量：

• 从终端启动VS Code：执行code .，这样VS Code会继承当前Shell的所有环境变量
• 或者在VS Code设置中开启终端环境继承：打开设置，搜索terminal.integrated.inheritEnv，确保选项设为true

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