如何将Jupyter Notebook（.ipynb）文件转换为PDF：最佳实践与工具指南
将Jupyter Notebook（.ipynb）转换为PDF：完整指南
Jupyter Notebook是数据分析和科学计算的利器，但分享或打印时往往需要PDF格式。本文将介绍四种主流通用方法：nbconvert命令、Web界面导出、Pandoc转换、以及使用LaTeX精修。每种方法都有适用场景，你可以根据需求选择。
方法一：使用nbconvert（最推荐）
Jupyter自带nbconvert工具，可直接将.ipynb转换为PDF。前提是系统已安装LaTeX（如MiKTeX、TeX Live）和Pandoc（可选）。
jupyter nbconvert --to pdf your_notebook.ipynb转换过程中，nbconvert会先生成.tex文件，再编译为PDF。如果遇到缺少包的错误，请安装相应LaTeX包，例如：sudo apt-get install texlive-latex-extra（Linux）或通过MiKTeX包管理器安装。
常见问题：中文支持
如果Notebook包含中文，需在.tex模板中加入CJK包，或使用--LatexPreprocessor.encoding=utf-8参数，并确保LaTeX配置支持中文字体。
方法二：Jupyter Web界面直接导出
打开Notebook后，依次点击 File → Download as → PDF via LaTeX。此方法依赖后端LaTeX配置，适合简短的Notebook。若转换失败，可先尝试通过Download as → HTML下载后，用浏览器打印为PDF。
方法三：使用Pandoc（灵活但需手动调整）
Pandoc支持多种格式互转，可通过pandoc命令将.ipynb先转为Markdown再转为PDF：
pandoc your_notebook.ipynb -o output.pdf --pdf-engine=xelatex这种方法对自定义模板和代码高亮有更好支持，但需要提前安装Pandoc和XeLaTeX。
方法四：在线工具与第三方应用
若本地环境配置困难，可尝试 nbconvert在线版（如CoCalc、Google Colab）或使用JupyterLab的PDF插件。注意：上传敏感数据需谨慎。
排版优化技巧
- 去掉代码输入：在nbconvert命令后加
--no-input参数，只显示输出结果。 - 添加目录：使用Markdown标题并启用
toc扩展。 - 调整页面大小：在LaTeX模板中设置
\geometry{margin=1in}。
常见错误及解决
| 错误信息 | 解决方案 |
|---|---|
| ! LaTeX Error: File ‘tcolorbox.sty’ not found. | 安装tcolorbox包：sudo tlmgr install tcolorbox |
| ! Package inputenc Error: Unicode character … | 使用XeLaTeX作为引擎：--pdflatex=xelatex |
| 无法生成PDF，日志过长 | 先输出.tex文件单独编译，排查错误：jupyter nbconvert --to latex |
总结：对于大多数用户，nbconvert --to pdf是最直接的方案。若遇到兼容性问题，可尝试Pandoc或Web导出。掌握这些方法，你就能轻松将.ipynb文件转化为精美PDF，方便分享与存档。