Windows系统下如何在VS Code中为Jupyter Notebook配置LaTeX

遇到的问题 #

• VS Code中Jupyter Notebook导出PDF失败，报错提示需安装xelatex：

  [error] If you have not installed xelatex (TeX) you will need to do so before you can export to PDF, for further instructions please look https://nbconvert.readthedocs.io/en/latest/install.html#installing-tex.To avoid installing xelatex (TeX) you might want to try exporting to HTML and using your browsers "Print to PDF" feature.

• 已通过pip安装Pandoc，但仍提示缺失，怀疑与TeX环境未配置好有关
• 已安装MikTeX及VS Code的LaTeX、LaTeX Workshop扩展，但仍无法导出PDF，且MikTeX包管理器显示空控制台
• 想了解VS Code中是否能像Overleaf一样用\usepackage{...}轻松引入包

解决方案 #

1. 修复MikTeX包管理器为空的问题 #

• 打开MikTeX Console，切换到「Packages」标签
• 点击右上角「Settings」，进入「Package repositories」页面
• 添加国内镜像源，点击「Refresh」刷新包列表，即可看到可用的TeX包

2. 确保xelatex和Pandoc可被系统识别 #

• 打开命令提示符，分别输入以下命令验证：

  xelatex --version
  pandoc --version
  

• 若提示“找不到命令”，将对应程序的bin目录添加到系统环境变量Path中：
  • MikTeX bin目录通常为C:\Program Files\MiKTeX\miktex\bin\x64
  • Pandoc目录通常为C:\Program Files\Pandoc
• 重启VS Code后再次验证

3. 配置MikTeX自动安装缺失包（模拟Overleaf体验） #

• 打开MikTeX Console，切换到「Settings」标签
• 将「Install missing packages on-the-fly」设置为「Always」
• 之后在.tex文件中使用\usepackage{...}时，编译过程会自动下载并安装缺失的包，和Overleaf操作一致

4. 无需TeX的PDF导出替代方案 #

• 在VS Code的Jupyter Notebook中，先导出为HTML格式
• 用浏览器打开导出的HTML文件，按下Ctrl+P选择「打印到PDF」，即可完成导出，完全不需要依赖TeX环境

内容的提问来源于stack exchange，提问作者Jaime Yepes de Paz