Mac系统下VSCode无法导出Jupyter Notebook为PDF的问题

问题背景 #

在VSCode中尝试导出Jupyter Notebook为PDF时，触发错误：

OSError: xelatex not found on PATH, if you have not installed xelatex you may need to do so.

但终端已验证xelatex安装正常：

$ xelatex
This is XeTeX, Version 3.141592653-2.6-0.999996 (TeX Live 2024) (preloaded format=xelatex)
 restricted \write18 enabled.

且/Library/TeX/texbin已加入系统PATH，同时在Jupyter Notebook服务器中导出PDF可正常运行。

解决方案 #

针对VSCode环境的修复方法如下：

• 重启VSCode：VSCode启动时会加载当时的环境变量，若你是在VSCode启动后才配置的TeX路径，重启后会重新读取PATH，多数情况下可解决问题。

• 手动配置VSCode终端环境变量：

  1. 打开VSCode设置（快捷键Cmd + ,）
  2. 搜索terminal.integrated.env.osx（Mac系统），Windows/Linux对应搜索terminal.integrated.env.windows或terminal.integrated.env.linux
  3. 添加TeX路径到PATH中，配置示例：

     "terminal.integrated.env.osx": {
         "PATH": "${env:PATH}:/Library/TeX/texbin"
     }
     

  4. 保存设置后重启VSCode

• 指定nbconvert的latex命令完整路径：

  1. 在VSCode设置中搜索jupyter.nbconvert.latexCommand
  2. 将值设置为xelatex的完整路径，例如：

     /Library/TeX/texbin/xelatex
     

• 修复虚拟环境的PATH配置：
  若使用了虚拟环境（如.venv），可在虚拟环境的激活脚本中添加TeX路径：

  1. 打开~/.venv/bin/activate（Mac/Linux）或~/.venv/Scripts/activate.bat（Windows）
  2. 添加以下内容：

     export PATH="/Library/TeX/texbin:$PATH"
     

  3. 保存后重新激活虚拟环境，再重启VSCode

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