环境准备

在开始配置之前,请确保已安装以下组件:

VSCode 必需插件:
- Jupyter
- Jupyter Notebook Renderers
- Python

在 Anaconda base 环境中安装必需包:

# 激活 base 环境
conda activate base

# 安装 pandoc (用于格式转换)
conda install pandoc

# 安装 nbconvert (用于 notebook 转换)
conda install nbconvert

# 安装 jupyter 相关包
conda install jupyter jupyter_client jupyter_core

# 验证安装
jupyter --version
pandoc --version
jupyter-nbconvert --version

提示：

如果 conda 安装较慢，可以添加国内镜像源

Windows 用户需要确保 MiKTeX 安装后执行了首次配置

Linux 用户建议使用系统包管理器安装 TeX Live 完整版

配置步骤

安装 LaTeX 环境

Windows 系统

Windows 系统安装 TeX Live 有两种方式:

方式一: 使用 Chocolatey (推荐)

1 2	# Windows (使用 chocolatey) choco install miktex

方式二: 通过 ISO 镜像安装 TeX Live

下载 ISO 镜像:
- 访问 CTAN 镜像站
- 下载 texlive.iso (约 4GB)
挂载 ISO 文件:
- 右键 ISO 文件,选择”挂载”
- 或使用解压软件解压到文件夹
运行安装程序:
- 进入挂载的驱动器或解压目录
- 运行 install-tl-windows.bat
安装配置:
- 选择安装方案: “完整安装”(推荐)
- 设置安装路径: 建议保持默认
- 选择纸张大小: A4
- 创建开始菜单快捷方式: 是
等待安装完成(约30-60分钟)
配置环境变量:
- 右键”此电脑” -> 属性 -> 高级系统设置 -> 环境变量
- 在”系统变量”的 Path 中添加:
  1
  C:\texlive\2023\bin\windows

验证安装:

1
2
3

# 打开命令提示符
xelatex --version
tlmgr --version

提示：

推荐使用国内镜像站下载,速度更快

安装过程中请保持网络连接

如遇安装失败,可尝试以管理员身份运行

建议安装完整版,避免后续缺包

Linux 系统

Ubuntu/Debian:

# 安装完整版 TeX Live
sudo apt install texlive-full

# 安装中文支持
sudo apt install texlive-lang-chinese

# 安装 XeTeX 引擎
sudo apt install texlive-xetex

# 验证安装
xelatex --version

CentOS/RHEL:

# 安装完整版 TeX Live
sudo yum install texlive-scheme-full

# 安装中文支持
sudo yum install texlive-lang-chinese

# 安装 XeTeX 引擎
sudo yum install texlive-xetex

# 验证安装
xelatex --version

提示：

建议使用系统包管理器安装,便于后续更新维护

完整版虽然体积大但能避免缺包问题

如遇依赖问题,可尝试分步安装

在 Anaconda 文件夹下检索 index.tex.j2

Windows 系统

打开文件资源管理器,进入 Anaconda 的安装目录,一般为 C:\Users\用户名\anaconda3
在该目录下搜索 index.tex.j2 文件
常见的路径有:
- C:\Users\用户名\anaconda3\Lib\site-packages\nbconvert\templates\latex
- C:\Users\用户名\anaconda3\share\jupyter\nbconvert\templates\latex
找到 index.tex.j2 文件并记住它的路径

提示: Windows 下可以使用 Everything 软件快速搜索文件

Linux 系统

打开终端，进入 Anaconda 的安装目录，一般为 ~/anaconda3

使用以下命令搜索 index.tex.j2 文件：

find ~/anaconda3 -name "index.tex.j2"
# 或使用 locate (需先更新数据库)
sudo updatedb
locate index.tex.j2

常见的路径有：
- ~/anaconda3/lib/python3.x/site-packages/nbconvert/templates/latex
- ~/anaconda3/share/jupyter/nbconvert/templates/latex
找到 index.tex.j2 文件并记住它的路径

提示: 建议在修改前备份原始模板文件

修改 index.tex.j2 模板文件

使用文本编辑器打开上一步找到的所有 index.tex.j2 文件

注意: 有些系统可能存在多个模板文件,建议全部修改以确保兼容性
找到 \documentclass 所在行，替换为以下内容：
1
2
3
4
5
6
((*- block docclass -*))
\documentclass[11pt]{article}
\usepackage{fontspec, xunicode, xltxtra}
\setmainfont{Microsoft YaHei}
\usepackage{ctex}
((*- endblock docclass -*))
各配置项说明：
- ((*- block docclass -*)) 和 ((*- endblock docclass -*)): Jinja2模板的块标记，用于覆盖原模板的文档类定义
- \documentclass[11pt]{article}: 设置文档类为 article，字号为 11pt
  - 可选字号: 10pt、11pt、12pt
  - 可选文档类: article(论文)、report(报告)、book(书籍)
- \usepackage{fontspec, xunicode, xltxtra}:
  - fontspec: 提供字体选择功能
  - xunicode: 提供 Unicode 支持
  - xltxtra: 提供 XeLaTeX 的额外功能
- \setmainfont{Microsoft YaHei}: 设置主字体为微软雅黑
  - 可自定义字体,必须使用系统已安装的字体名称
  - 建议使用等宽字体以获得更好的代码显示效果
- \usepackage{ctex}: 加载 ctex 宏包，提供中文支持
  - 可选参数: UTF8(默认)、GBK、GB2312 等编码
  - 示例: \usepackage[UTF8,fontset=windows]{ctex}
保存 index.tex.j2 文件

注意：
字体名称必须是系统已安装的字体

Windows 常用中文字体：

SimSun(宋体): 正文首选,清晰度好

Microsoft YaHei(微软雅黑): 标题首选,现代感强

KaiTi(楷体): 适合注释和引用

SimHei(黑体): 适合强调内容

Linux 常用中文字体：

Noto Sans CJK SC: Google开源字体,兼容性好

WenQuanYi Micro Hei: 文泉驿微米黑,开源字体

可以用 fc-list :lang=zh 命令查看系统安装的中文字体
字体设置可以分别指定不同场景:
1
2
3
\setmainfont{Microsoft YaHei}     % 主要字体
\setsansfont{SimHei}              % 无衬线字体
\setmonofont{Consolas}            % 等宽字体(代码)

验证配置

在 VSCode 中打开任意 .ipynb 文件
点击右上角的导出按钮,选择 “Export to PDF”
等待转换完成,检查生成的 PDF 文件