在VSCode中写Latex

最近在 OverLeaf 中修改一份论文，奈何文件太大，编译器巨困难，而且经常崩溃，于是决定在本地写论文，于是便找到了 VSCode+LaTex。下面记录全部的环境搭建过程：

安装VSCode

VSCode的安装非常简单，直接去官网下载安装包，然后双击安装即可。

安装LaTex

LaTex的安装稍微麻烦一些，针对不同的系统有不同的安装包。而且不同系统的安装还有不同的坑，如果是window系统可以参考安装教程, 如果是mac系统，安装方式则更加简单，直接去清华源下载 MacTeX.pkg，然后双击安装即可。

安装VSCode插件

• LaTeX Workshop

用户配置

command+shift+p 搜索 settings.json 选择 “打开用户设置(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": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "-outdir=%OUTDIR%",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],
    "latex-workshop.latex.recipes": [
        {
            "name": "pdflatex -> bibtex -> pdflatex*2",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        },
        {
            "name": "XeLaTeX",
            "tools": [
                "xelatex"
            ]
        },
        {
            "name": "PDFLaTeX",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "BibTeX",
            "tools": [
                "bibtex"
            ]
        },
        {
            "name": "LaTeXmk",
            "tools": [
                "latexmk"
            ]
        },
        {
            "name": "xelatex -> bibtex -> xelatex*2",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
    ],
    "latex-workshop.latex.clean.fileTypes": [
        "*.aux",
        "*.bbl",
        "*.blg",
        "*.idx",
        "*.ind",
        "*.lof",
        "*.lot",
        "*.out",
        "*.toc",
        "*.acn",
        "*.acr",
        "*.alg",
        "*.glg",
        "*.glo",
        "*.gls",
        "*.ist",
        "*.fls",
        "*.log",
        "*.fdb_latexmk"
    ],
    "latex-workshop.latex.autoClean.run": "onFailed",
    "latex-workshop.latex.recipe.default": "lastUsed",
    "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",
    "[latex]": {
        "editor.defaultFormatter": "James-Yu.latex-workshop"
    },

重启VSCode

• 完成上述配置后，一定要重启VSCode，否则配置不会生效。
• Latex Workshop插件会自动检测你的LaTeX文件，如果不是 .tex 文件，则不会有对应的环境。

编译

• 编译完成后，发现没有参考文献，这是因为没有运行 bibtex 命令，需要选择 pdflatex -> bibtex -> pdflatex*2 或者 xelatex -> bibtex -> xelatex*2。