直接点击“导出为 PDF”常失败，是因为VSCode内置Jupyter扩展不自带LaTeX引擎，而nbconvert默认依赖pdflatex；未安装TeX环境时会报“pdflatex not found”或卡在导出中。
为什么直接点击“导出为 PDF”经常失败
VSCode 内置的 Jupyter 扩展不自带 LaTeX 引擎，而 jupyter nbconvert 默认依赖 pdflatex 生成 PDF。没装 LaTeX 环境时，你会看到类似这样的错误：PDF export failed: Command 'pdflatex' not found，或者卡在“Exporting…”不动。
解决思路不是硬凑 VSCode 图形界面按钮，而是明确分两步：先确保 notebook 能被正确执行（含代码输出），再用命令行工具导出。图形按钮只是快捷入口，底层仍调用 nbconvert。
- Windows 用户推荐安装
TeX Live（完整版）或轻量级tinytex（通过 R 包安装更方便，但需额外配置路径） - macOS 用户用
brew install --cask mactex或tlmgr install collection-latex（如果已装 tinytex） - Linux 用户运行
sudo apt install texlive-xetex texlive-fonts-recommended texlive-plain-generic（Ubuntu/Debian） - 装完后终端运行
pdflatex --version能返回版本号才算就位
怎样让 notebook 在导出前自动执行所有单元格
默认导出不会重新运行代码——它只把当前编辑器里已有的输出（包括空输出、报错、未执行的单元格）打包进 PDF。结果常是空白图、NameError 或“Output not found”。必须显式要求执行。
最可靠的方式是用命令行加 --execute 参数，而不是依赖 VSCode 右键菜单里的“Export as PDF”：
jupyter nbconvert --to pdf --execute my_notebook.ipynb
-
--execute强制逐单元运行，失败则中断导出（可加--allow-errors容忍部分报错） -
--no-input可选，隐藏代码块本身，只留输出和 Markdown 渲染结果 - 若 notebook 依赖相对路径的文件（如
data.csv），请先cd到其所在目录再运行命令，否则执行会因路径错误而失败 - VSCode 终端里执行时，确认当前工作区根目录与 notebook 文件位置一致，否则
nbconvert可能找不到依赖模块
导出 PDF 时中文显示为方块或乱码怎么办
这是字体缺失的典型表现。nbconvert 默认用 Latin 字体，对中文、日文等 Unicode 字符支持极弱。不能靠改 VSCode 设置解决，得干预 LaTeX 模板或编译参数。
推荐方案是切换到 XeLaTeX 引擎，并指定系统中文字体：
jupyter nbconvert --to pdf --pdf-engine=xelatex --template classic --no-input my_notebook.ipynb
-
--pdf-engine=xelatex是关键，它支持 TrueType/OpenType 字体；pdflatex不行 -
--template=classic避免新版base模板里某些未适配 XeLaTeX 的宏定义 - 若仍有乱码，需手动创建一个
custom.tplx模板，在导出命令中用--template=custom.tplx替代，里面加入\setmainfont{Noto Sans CJK SC}（macOS）、SimSun（Windows）或Noto Sans CJK JP（Linux） - 注意：VSCode 内置导出不支持传入
--pdf-engine，所以这一步必须走终端
有没有更轻量、不依赖 LaTeX 的替代方案
有，但代价是格式控制力下降。如果你只需要快速生成可读 PDF，且不介意页眉页脚简陋、数学公式渲染偏弱，可以用 HTML 中转：
jupyter nbconvert --to html --no-input my_notebook.ipynb && wkhtmltopdf my_notebook.html my_notebook.pdf
-
wkhtmltopdf是命令行网页转 PDF 工具，跨平台，中文支持好（只要系统有对应字体） - 需提前安装：
brew install wkhtmltopdf（macOS）、choco install wkhtmltopdf（Windows）、sudo apt install wkhtmltopdf（Ubuntu） - 缺点明显：交互式图表（如 Plotly、ipympl）会丢失动态能力，仅保留静态快照；LaTeX 公式渲染质量不如原生 nbconvert + XeLaTeX
- VSCode 插件
Export Notebook as PDF（作者：mattzcarey）底层就走这个链路，但稳定性一般，出错时建议还是回到上面的命令行组合
真正麻烦的从来不是“点哪个按钮”，而是 notebook 是否干净可复现、LaTeX 环境是否完整、字体路径是否被识别。这三个点卡住任何一个，PDF 就会停在半路。
