前言
一般情况下我们都希望在 vscode 一个软件内尽量完成我们所有的工作，就像 chrome 搭载很多插件一样，我们希望能在 chrome 里尽可能做到全能。虽然有很多好用的 LaTex 编辑器，但是我们就是想在 vscode 里做到写 LaTex ，到 2020 如今已是一件很简单的事。
那就开始介绍从零开始用 vscode 作为编辑器 + 使用 LaTex Workshop 插件 + Texlive 2020 编译环境开始书写我们的 LaTex 。
安装 LaTex 环境
下载 Texlive 2020 并安装，Texlive 是 LaTex 的编译环境，提供了大量的脚本和宏包供我们使用，并且有很方便的宏包管理器可以下载更新宏包，十分方便。
下载
有两种方式：
- 官网下载页面：在官网下载安装程序，但其不包括本体，在线下载安装 4 小时左右。
- 通过镜像源下载
.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 | 编译工具选项，也就是我们上面在 |
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 编译选项就可以。
