VS Code + LaTeX

相比于Word来说LaTeX的优点在于：

• 拥有丰富的模板，排版所需的时间要小于Word
• 写公式和排版公式非常方便，特别是当涉及大量公式时
• 当你需要更换模板时可以非常快速地套用另一个LaTeX模板，基本不需要修改

相比于Word来说LaTeX的缺点在于：

• 上手复杂，光是安装和环境配置都比Word要难出几个数量级
• 当出现错误时很难定位错误，LaTeX的错误日志并不是很容易理解，特别是遇到一些摸不着头脑的错误时
• 当你不满足于套模板，想要根据自己的需要修改格式时，工作量就会大幅攀升，同时LaTeX没有一个User-friendly 区（StackExchange可能好一点

一、安装TeXLive

TeXLive即LaTeX的编译环境，最新版本为2019，在其官方 站可以进行下载。对于mac可以进行下载。对于macOS用户，下载MacTeX 2019直接运行安装即可。对于Windows和Linux用户，有两种下载方式：

• 在线下载：访问https://www.tug.org/texlive/acquire-netinstall.html下载install-tl-windows.exe（Windows）或者install-tl-unx.tar.gz（Linux）。Windows下使用管理员权限运行install-tl-windows.exe，Linux下使用sudo命令运行解压install-tl-unx.tar.gz后得到的install-pl脚本。
• 离线下载：访问THU开源镜像站下载TeXLive的ISO镜像，用虚拟光驱装载后，Windows下使用管理员权限运行install-tl-windows.exe，Linux下使用sudo命令运行install-pl脚本。

运行后会启动安装程序，可以根据需要进行修改，或者直接点击“安装”：

在等待一段时间后安装完成。

接下来测试LaTeX是否正常安装。在命令提示行/终端中运行命令：

如果显示如下，说明安装正确：

如果显示“找不到命令”等等提示，需要进一步将TeXLive安装路径加入PATH环境变量中，具体参见：

二、安装并配置VS Code

接下来我们需要安装LaTeX Workshop插件，可以通过两种方式安装，一是在侧边栏的扩展选项卡中查找LaTeX Workshop并点击安装：

二是访问插件主页进行安装：

安装完成后打开一个.tex文件即可看到，整个文件已经支持代码高亮：

主要分为：

• 功能区，提供大部分主要功能
• 大纲
• 预览区，提供PDF文件的预览，每次保存都会自动刷新

具体LaTeX Workshop插件的配置可以参考官方文档（英文）：

https://github.com/James-Yu/LaTeX-Workshop/wiki/Installgithub.com

这里针对常用功能进行说明：

1. 编译生成

LaTeX Workshop中有两个概念需要了解：工具（Tools）和组合（Recipe）。工具（Tool）指编译器，常见的主要有pdfLaTeX、XeLaTeX、LuaLaTeX等，他们之间的区别见：

TeX 家族 · 一份其实很短的 LaTeX 入门文档 · 看云www.kancloud.cn

在这里我们只需要知道他们是不同的编译器即可。模板一般会指定编译时使用的编译器，如果不确定的话不妨都试一试。组合（Recipe）即编译器的组合使用，当你的LaTeX文件涉及引用等比较复杂的需求时需要进行组合编译。LaTeX Workshop本身提供了多个编译组合，在功能区中点击“Build LaTeX Project”可以看到所有默认组合：

以pdfLaTeX→bibTeX→pdfLaTeX * 2为例，它会先运行一次pdfLaTeX，一次bibTeX，再运行两次pdfLaTeX，最终生成带有交叉引用的完整PDF。这是最常用的编译组合。在这里还可以看到Terminate选项，当编译时间过长时可以选择中止。

LaTeX Workshop每次默认会采用第一个编译组合进行编译，可以在设置中进行修改成最后一次使用的：

此外，LaTeX Workshop默认在保存的时候自动编译，可以修改为不自动编译：

如果你想要加入自定义的工具或者编译组合，可以参考我的配置：

LaTeX Workshop Config – 代码片段 – 码云 Gitee.comgitee.com

其中主要涉及两个配置：”latex-workshop.latex.tools”用以指定工具，”latex-workshop.latex.recipes”用以指定编译组合。也可以参考官方文档：

Compile · James-Yu/LaTeX-Workshop Wikigithub.com

具体如何打开自定义配置，如下图所示：

2. 正向搜索和反向搜索

LaTeX Workshop支持从.tex文件跳转到PDF相应位置（正向搜索），以及从PDF跳转到.tex相应位置（反向搜索）。

正向搜索直接在功能区内找到“SyncTeX from cursor”即可：

反向搜索直接在预览区PDF的文字上按住Ctrl+左键即可自动跳转。

需要注意的是不要删除XeLaTeX生成的.synctex.gz文件，否则正向/反向搜索功能将会失效。

3. 公式符

在功能区内找到“Snippet Panel”，即可插入常用的公式符 和命令。

4. 快捷键

LaTeX Workshop本身的快捷键比较复杂，可以在设置中自行修改：

三、配置Zotero

写论文的过程中另一个比较麻烦的点是参考文献的管理和引用。在这里安利一个优秀的文献管理软件Zotero，不仅免费、开源且支持中文，目前也有一些优秀的插件。首先访问Zotero官方 站进行下载安装，推荐同时安装Zotero Connector浏览器插件，可以自动将Google Scholar、arXiv等 站上的论文自动添加到文献库中。（如果要安装Safari版Connector请参考这里。）

安装完成以后Zotero可以直接使用，但是以下两个插件可以使得Zotero更优化：

1. ZotFile

ZotFile可以自动为下载的PDF文件按照一定格式进行重命名，同时还可以使Zotero支持OneDrive、iCloud和坚果云等第三方云存储（Zotero本身提供云存储，但是价格比较贵）。

首先从ZotFile官方 站下载插件，然后在Zotero工具栏中点击“工具”→“插件”打开“插件”窗口，选择“从文件安装插件…”选中刚才下载的.xpi文件安装并重启。

接下来需要进行设置，在工具栏中点击“工具”→“ZotFile Preferences…“打开设置窗口，主要需要设置两部分：

1. General Setting，主要包括文件存储位置

2. Renaming Rules，主要包括文件命名规则

文件夹和文件的命名规则具体可参考官方文档。

将存储位置指定为云存储的文件夹后，每当通过Zotero Connector添加文献时，自动下载的文献会被重命名并移动到云存储中，这样就可以实现多终端自动同步。

2. Better BibTeX for Zotero

重头戏，通过这个插件可以自动生成BibTeX文件，还支持自动更新等诸多高级功能。首先登录官方GitHub下载插件，安装方法和ZotFile一致。

安装完成后重启，在左侧选择一个分类点击右键并选择“导出分类”，在其中选择“Better BibLaTeX”，在下方勾选“Keep updated”，并指定文件导出，这样就可以完成文献管理+自动生成BibTeX文件：

四、其他

LaTeX Git Ignore – 代码片段 – 码云 Gitee.comgitee.com

最后再推荐一个VS Code插件 LaTeX Utilities：

LaTeX Utilities – Visual Studio Marketplacemarketplace.visualstudio.com

可以提供图片/表格自动粘贴、文档字数统计和Zotero引用管理等功能。

参考