Mac系统VSCode将Python文件导出为PDF报错问题求助

你已安装nbconvert、jupyter、MacTex后仍然导出失败，可按以下步骤逐一排查：

1. 修复MacTex环境变量配置 #

MacTex默认安装后不会自动添加全局环境变量，导致VSCode无法识别到LaTeX引擎：

• 打开终端执行echo $PATH，检查是否存在/Library/TeX/texbin路径
• 如无该路径，编辑对应shell配置文件：
  • 使用zsh的用户编辑~/.zshrc，使用bash的用户编辑~/.bash_profile
  • 在配置文件末尾添加export PATH="/Library/TeX/texbin:$PATH"
  • 执行source ~/.zshrc（对应zsh）或source ~/.bash_profile（对应bash）使配置生效
• 验证配置：终端执行xelatex --version，正常输出版本信息即为配置成功

2. 补全导出依赖 #

• 升级nbconvert并安装pandoc依赖：pip3 install --upgrade nbconvert pandoc
• 安装系统层面的pandoc工具：brew install pandoc

3. 调整VSCode Jupyter扩展配置 #

• 打开VSCode设置页面，搜索Jupyter: PDF Export Latex Engine，将值修改为xelatex，解决默认引擎对中文支持不足的问题
• 确认VSCode当前使用的Python解释器，和你安装nbconvert、jupyter的Python环境一致，避免虚拟环境/多版本Python导致的包找不到问题

4. 手动导出验证定位问题 #

如果上述配置完成后仍然报错，可以先通过终端执行导出命令，定位是工具链问题还是VSCode配置问题：

1. 先将Python文件转换为ipynb格式：jupyter nbconvert --to ipynb 你的文件路径.py
2. 再执行PDF导出命令：jupyter nbconvert --to pdf 你的文件路径.ipynb --pdf-engine=xelatex

• 如终端可正常导出PDF，重启VSCode或重新加载Jupyter扩展即可
• 如终端也报错，可按照终端提示安装缺失的LaTeX包，常见的中文支持包可通过sudo tlmgr install ctex安装

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