已安装MacTeX，Mac环境下通过LaTeX转换Jupyter Notebook Markdown至PDF时出现xelatex不在PATH中的问题求助

我之前也踩过这个坑！MacTeX安装完成后，经常不会自动把TeX的命令行工具路径添加到系统的PATH环境变量里，这就导致nbconvert找不到xelatex。试试下面这些步骤来修复：

第一步：确认xelatex的实际路径 #

打开终端，输入这条命令来查找xelatex的位置：

find /usr/local/texlive -name xelatex

你会得到类似这样的输出（年份可能不同）：

/usr/local/texlive/2024/bin/universal-darwin/xelatex

重点记住/usr/local/texlive/2024/bin/universal-darwin这个目录路径。

第二步：把TeX路径添加到系统PATH #

根据你使用的终端shell类型，修改对应的配置文件：

• 如果你用的是Zsh（Mac默认shell）：
  打开终端输入：

  open ~/.zshrc
  

  在文件的末尾添加一行（把路径换成你刚才找到的实际路径）：

  export PATH="/usr/local/texlive/2024/bin/universal-darwin:$PATH"
  

  保存文件后，回到终端输入：

  source ~/.zshrc
  

  让配置立即生效。

• 如果你用的是Bash：
  打开终端输入：

  open ~/.bash_profile
  

  同样在末尾添加上面的export语句，保存后输入：

  source ~/.bash_profile
  

第三步：验证配置是否成功 #

在终端输入：

xelatex --version

如果能正常显示xelatex的版本信息，说明路径配置成功了，这时候再运行nbconvert转换Jupyter Notebook到PDF应该就不会报错了。

备选方案：重新安装MacTeX时勾选命令行工具 #

如果上面的步骤嫌麻烦，你可以重新运行MacTeX的安装包，点击「Customize」按钮，确保TeX Live Utility和Command Line Tools这两个选项都被勾选上，安装完成后系统会自动配置PATH。

内容的提问来源于stack exchange，提问作者Dan Öz