### Jupyter Notebook 导出 PDF 失败的解决方案 当遇到 `nbconvert failed: xelatex not found on path` 的错误时，通常是因为缺少 LaTeX 编译器或者其路径未被正确设置。以下是几种常见的解决方法： #### 方法一：安装并配置 XeLaTeX 或者 TeX Live 为了支持通过 LaTeX 转换为 PDF 文件的功能，需要先安装完整的 TeX 发行版（如 TexLive 或 MiKTeX），因为它们包含了必要的工具链来处理 `.tex` 到 `.pdf` 的转换。 在 Mac 和 Linux 上可以运行以下命令来安装依赖项： ```bash sudo apt-get install texlive-xetex texlive-fonts-recommended texlive-generic-recommended ``` 对于 macOS 用户，可以通过 Homebrew 安装： ```bash brew cask install mactex ``` 完成上述操作后重新尝试导出 PDF 命令： ```bash jupyter nbconvert --to pdf your_notebook.ipynb ``` 此过程可能会因环境差异而有所不同[^1]。 --- #### 方法二：先导出 HTML 再打印成 PDF 另一种更简单的办法是先把 Jupyter Notebook 转换成 HTML 格式，然后再利用浏览器功能将其保存为 PDF 文档。这种方式无需额外安装复杂的软件包即可实现基本需求。 具体步骤如下所示： 1. 使用下面这条指令把 IPython 笔记本转码至静态网页形式； ```bash jupyter nbconvert --to html your_notebook.ipynb ``` 2. 打开生成好的 HTML 页面，在大多数现代浏览器里按下组合键 Ctrl+P (Windows/Linux) 或 Command+P (macOS)，选择目标设备为“另存为 PDF”，最后点击确认按钮即成功创建所需文档[^3][^4]。 需要注意的是，这种途径虽然简便易行，但对于较大规模的内容可能存在截断现象等问题。 --- #### 方法三：调整文件命名与资源嵌入方式 另外两个值得注意的小技巧分别是更改工作簿名称去除其中任何非 ASCII 字符串部分以防乱码情况发生；还有就是确保所有的多媒体素材都以内联模式存在而不是外部链接指向的形式呈现出来以免影响最终渲染质量[^2]。 例如修改原名为带有汉字字符的工作薄标题改为纯英文字母构成的新名字：“我的报告”.ipynb -> my_report.ipynb 。同时下载网络上的图像资料存储到本地目录下并通过相对地址引用这些对象而非绝对 URL 地址。 --- 综上所述，针对不同场景可以选择适合自己的策略去应对该类难题。无论是完善系统级组件还是采用迂回战术都能有效缓解此类状况带来的困扰。