点“导出为 pdf”失败是因为缺pdflatex或未执行代码单元；nbconvert默认不运行notebook，需用jupyter nbconvert --to pdf --execute --no-input --template cn命令导出。
直接点 VSCode 或 Jupyter 界面里的“导出为 PDF”按钮，大概率失败——不是你 notebook 写得不对，而是底层缺 pdflatex 或没执行代码单元格。
为什么点“导出为 PDF”总卡住或报错
VSCode 内置 Jupyter 扩展、Jupyter Classic 和 JupyterLab 的“Download as → PDF via LaTeX”菜单项，底层都调用 jupyter nbconvert，而它默认走 LaTeX 编译路径：先转成 .tex，再用 pdflatex 编译。没装 LaTeX 环境时，你会看到：
PDF export failed: Command 'pdflatex' not found- 导出进度条卡在 “Exporting…” 不动
- 生成空 PDF 或只含 Markdown 文本，图表/输出全丢
这不是 bug，是设计如此：nbconvert 默认不重新运行 notebook，只打包当前编辑器里已有的输出（包括空输出、报错、未执行单元格）。
最稳的命令行导出方式（带执行+中文支持）
别依赖图形界面按钮，用终端跑这条命令：
jupyter nbconvert --to pdf --execute --no-input --template cn my_notebook.ipynb
说明：
-
--execute：强制逐单元运行，遇到错误会中断（加--allow-errors可跳过单个失败单元） -
--no-input：隐藏代码块，只保留输出和 Markdown 渲染结果（适合交付文档） -
--template cn：指定自定义中文模板（需提前建好cn模板文件夹，含conf.json和index.tex.j2，并确保已装ctex、xeCJK等宏包） - 务必先
cd到 notebook 所在目录再执行，否则相对路径（如data.csv）会读取失败
Windows/macOS/Linux 安装 LaTeX 引擎要点
装完后必须验证 pdflatex --version 能返回版本号，才算就位：
- Windows：装
MiKTeX（选 “Install missing packages on-the-fly: Yes”），别用 TeX Live；Pandoc 必须从官网下.msi安装，别用 pip - macOS：用
brew install --cask mactex，或装tinytex后运行tlmgr install collection-latex - Linux（Ubuntu/Debian）：
sudo apt install texlive-xetex texlive-fonts-recommended texlive-plain-generic
中文支持不是装完 MiKTeX 就自动好——首次编译时，MiKTeX Console 会弹窗提示安装缺失宏包，按提示点“是”即可，关键包包括 ctex、fontspec、xeCJK。
临时救急：不用 LaTeX 的浏览器打印法
如果只是快速分享、不追求公式排版或分页控制，用浏览器打印最省事：
- 在 Jupyter 或 VSCode 中打开 notebook，手动运行所有单元格（确保输出存在）
- 按
Ctrl+P（Windows/Linux）或Cmd+P（macOS）调出打印面板 - 打印机选 “Save as PDF”，布局设为 “Landscape”（横向），缩放调到 80%–90% 防代码溢出
- 注意：动态图表（如 Plotly）、交互控件、复杂表格分页容易错乱，且无书签
真正要生成可交付的 PDF（比如论文附录、项目报告），LaTeX 路径仍是唯一可靠选择；浏览器打印只是应急，别把它当主力方案。
