vscode写LaTex教程 | 从零开始使用Texlive+vscode+LaTex Workshop插件配置

前言

一般情况下我们都希望在 vscode 一个软件内尽量完成我们所有的工作，就像 chrome 搭载很多插件一样，我们希望能在 chrome 里尽可能做到全能。虽然有很多好用的 LaTex 编辑器，但是我们就是想在 vscode 里做到写 LaTex ，到 2020 如今已是一件很简单的事。

那就开始介绍从零开始用 vscode 作为编辑器 + 使用 LaTex Workshop 插件 + Texlive 2020 编译环境开始书写我们的 LaTex 。

安装 LaTex 环境

下载 Texlive 2020 并安装，Texlive 是 LaTex 的编译环境，提供了大量的脚本和宏包供我们使用，并且有很方便的宏包管理器可以下载更新宏包，十分方便。

下载

有两种方式：

1. 官网下载页面：在官网下载安装程序，但其不包括本体，在线下载安装 4 小时左右。
   
2. 通过镜像源下载 .iso 再安装，安装过程 30 分钟 - 3 小时不等：
   ①官方下载 .iso 地址
   ②清华镜像下载 .iso

安装

安装是老生常谈了，教程有很多，可以参考 百度经验：
Latex：安装Texlive

管理宏包

有时候我们在初始安装的时候 custom 选择的宏包并不全，或者有新宏包需要更新，这个时候就需要用到 宏包管理器 。
在安装根目录可以找到管理工具 tl-tray-menu.exe ：

打开后并没有主窗口弹出，需要在右下角打开宏包管理：

打开后是空白的，此时正在加载本地宏包列表，一定要等待加载完毕显示出来，否则乱点就会导致网络错误炸掉：

加载完毕后可以看到本地库列表：

点击第一列的第二个按钮 全部 ，展示所有宏包（包括在线）：

此时出现 start ，如果没出现这一行，是全白的或者是 Done 开头的，那十有八九会有网络崩溃提示，窗口会被强制关闭，要重新来这一步。
加载成功后点击关闭：

此时在搜索框里搜索你需要的宏包名即可：

选择宏包后右键安装：

等待 5 - 10 分钟安装完毕，这个过程有时候比较漫长，因为下载完毕还要刷新本地 hash ，要静静等待。

使用 vscode

安装 LaTex Workshop

插件市场安装 LaTex Workshop 插件：

之后在左侧栏就会出现 TEX 功能菜单可供使用，新建一个 .tex 文件就可以进行测试了~

注：每一次打开 vscode 是不会加载 TEX 功能菜单的，只有当打开 .tex 文件时才会加载 LaTex Workshop 的相关功能面板，这点和加载 js/ts 或是 python 功能是一样的，何时使用何时加载。有时候加载功能面板比较慢，要等一会等待 TEX 面板出现。

TEX 面板功能

一般情况下我们常用前三个功能，第一个是构建相关功能、第二个是展示 pdf ，第三个是打开日志用于查错：

他们都有对应的列表，可以展开，如果直接点击而不是展开，默认执行离行首最近的第一条相关命令：

↑ 在这里如果直接点击 Build LaTex project 就会直接执行 latexmk 编译（现在还没有配置，默认是 pdflatex 编译文件）

↑ 一般情况我们都选择在 vscode 的分屏 tab 里展示编译好的 pdf ，左边写右边可视比较人性化，该插件会在 tab 内使用 pdf.js 进行加载编译好的 pdf ，同时支持双向搜索（索引）功能。

↑ 通常情况下我们在意的是编译情况的日志，错误也一般都是从这里查到的。

现在能做的事

现在已经熟悉了 LaTex Workshop 插件，但是目前只能编译英文的文档，中文是不支持的，需要进一步配置编译顺序。

配置 LaTex Workshop

在 settings.json 里增加如下内容：

"latex-workshop.latex.tools": [
	{
		"name": "xelatex",
		"command": "xelatex",
		"args": [
			"-synctex=1",
			"-interaction=nonstopmode",
			"-file-line-error",
			"%DOCFILE%"
		]
	},
	{
		"name": "pdflatex",
		"command": "pdflatex",
		"args": [
			"-synctex=1",
			"-interaction=nonstopmode",
			"-file-line-error",
			"%DOCFILE%"
		]
	},
	{
		"name": "bibtex",
		"command": "bibtex",
		"args": [
			"%DOCFILE%"
		]
	}
],

"latex-workshop.latex.recipes": [
	{
		"name": "xelatex",
		"tools": [
			"xelatex"
		],
	},
	{
		"name": "pdflatex",
		"tools": [
			"pdflatex"
		]
	},
	{
		"name": "xe->bib->xe->xe",
		"tools": [
			"xelatex",
			"bibtex",
			"xelatex",
			"xelatex"
		]
	},
	{
		"name": "pdf->bib->pdf->pdf",
		"tools": [
			"pdflatex",
			"bibtex",
			"pdflatex",
			"pdflatex"
		]
	}
],

这段配置含义如下：

参数	含义
latex-workshop.latex.tools	编译工具选项，也就是我们上面在 Build LaTex project 下拉菜单看到的，只要在这里配置了 tools ，就会新增到下拉菜单里供我们选择。
latex-workshop.latex.recipes	配置每一个编译的小环境，有使用 xelatex 的，也有使用 pdflatex 的，或是 xe->bib->xe->xe 连续多次编译的（多次编译的目的是为了生成参考文献，这是 bibtex 的性质决定的）。

也就是说，在 latex-workshop.latex.recipes 内配置好每一个小环境执行什么样的编译步骤，并在 latex-workshop.latex.tools 工具选项卡里添加，即可在 Build LaTex project 菜单使用我们自己定义的编译小环境以及相应的命令。

上手

至此，已经完成了 vscode 的配置，我们利用 xelatex 对汉语的良好支持性就可以编译带汉字的文章！重启 vscode ，下次编译选择我们配置的 xelatex 编译选项就可以。