VScode配置Latex环境（VScode+texlive）

引言

  作为一款能够自动排版，简洁美观的文本编辑工具。Latex深得科研工作者和广大竞赛选手的喜爱。笔者之前一直使用texstudio+miktex的搭配编辑latex文本。但作为重度颜控，texstudio过时的审美风格实在难以让人恭维。因此，借着课程大作业的机会，笔者重新在VScode中配置了Latex环境，并以此篇博客作为记录。

资源下载

VScode：VScode官网
Texlive：https://link.zhihu.com/

安装

  关于VScode的安装不用多说，类似的教程也有很多，这里主要讲一下texlive的安装过程。首先打开texlive.iso镜像文件，并运行批处理程序。

  打开安装程序后按步骤确认安装即可。需要注意的是在安装时可以取消安装多余的包，节省安装空间。
  （选择Customize取消多余安装包）

  （光是取消中英文之外的宏包就可以省下1G的安装空间）

VScode内部设置

  VScode是一款出色的小体量文本编辑软件。相比较其他的编译软件，VScode丰富的拓展包使其能够对多种语言进行编译。在布置latex环境之前，首先需要安装latex对应的拓展包，如下图：

此时打开一份tex源文件，可以看到其中的代码部分已经高亮显示。

  完成拓展包安装之后，我们需要对latex的编译链与编译环境进行配置。由于笔者最近使用的大多是latex中文环境，这里选择了xelatex作为latex编译环境。首先打开VScode界面，选择任意tex源文件打开，按F1打开首选项：打开设置（json）。

  配置xelatex的json文件如下：

    "latex-workshop.latex.tools": [
        {
            "name": "xelatex",  //这里使用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%"
            ]
        }
    ],

  这里，笔者选择的编译链是xelatex->bib->pdf，读者可以根据自己的需要配置其他编译链，类似教程网上有很多，大家自行查找。编译链配置文件如下：

"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.view.pdf.viewer": "tab",  //设置默认pdf阅读器为vscode内置阅读器
    "latex-workshop.latex.autoBuild.run": "onFileChange",
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": false,

  完整的配置文件如下，可以直接放在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.view.pdf.viewer": "tab",
    "latex-workshop.latex.autoBuild.run": "onFileChange",
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": false,
}

  此时打开侧边栏，可以看到修改的设置已经在列表当中了。

  到这里为止，VScode中latex环境的配置就结束了，预览效果如下：