Vscode使用LaTeX过程记录与疑难问题解决

为什么要使用Vscode编辑LaTeX?

使用LaTeX已经有近一年的时间了，但是大部分时候使用的工具还是overleaf网站等在线工具。作为小白，使用overleaf的使用体验还是不错的，但是免费版的overleaf只支持20s的编译时长，对于一些编译时长超过20s的文档就要开会员版。而且使用overleaf编译较慢，调试bug较难，文档的安全性难以保证。所以最近还是想要切换到本地编辑器上来。

通过比较几款本地编辑器，最终还是选择了功能十分强大的vscode。它可以结合多种插件扩展性比较强。比如可随时同步GitHub，结合overleaf使用实现在线编辑和本地编辑的同步。或者结合Zotero实现参考文献直接插入，十分方便。

如何使用Vscode编辑LaTeX?

• 下载安装texlive

可以使用官方网站，选择texlive2019.iso进行下载：http://www.tug.org/texlive/

如果希望下载更快，可以使用国内的镜像网站：https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/

点开镜像站后，选择 texlive2019.iso进行下载。

这里文件大小通常在4~5个G，下载较慢，尽量使用国内镜像网站，另外软件安装较慢，通常需要半小时以上，建议耐心等待。

• 下载安装vscode

直接到官网下载最新版的 vscode ，当然官网需要科学上网，不然下载很慢，当然也有其他的法子。

这里我们需要记住 vscode 的安装路径，后面需要用到

• 在vscode中安装拓展latexworkshop

安装好vscode后需要在拓展中安装这款插件。

• 配置setting json文件

安装好插件我们重启一下 vscode ，点击左下角齿轮，打开设置，并打开配置文件 settings.json 。或者按ctrl+shift+p打开一下界面

然后点击“打开用户设置”进入以下界面

在settings.json中加入以下代码

{
    "latex-workshop.latex.autoBuild.run": "never",
    "latex-workshop.showContextMenu": true,
    "latex-workshop.intellisense.package.enabled": true,
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": false,
    "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": "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"
            ]
        },
        {
            "name": "pdflatex -> bibtex -> pdflatex*2",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        },
    ],
    "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",
}

 此时点击下图中的build latex project

按照其他教程，一般情况下就可以编译出对应的PDF文件了。但是很多用户包括我的设备会报错“Recipe terminated with error. Retry building the project.”以及“I can't find the format file `pdflatex.fmt'!”

我所遇到的疑难杂症是如何解决的？

通过查找网上各种教程，询问各路大神，找到了几条可能的解决对策分享给大家。

1. 可能是文件路径中包含中文路径。解决的对策很简单，将文件放在英文路径下即可解决
2. 可能没有配置环境变量。相应地，直接在环境变量中添加“C:\texlive\2021\bin\win32”以及“C:\Windows\System32”即可解决。
3. 如果此时还是提示错误，在cmd中输入以下命令“fmtutil-sys --all”即可。这里需要注意，需要以管理员身份运行cmd。

至此，全部操作已完成，可以愉快地使用vscode编写文档了！

总结

在历经数次失败，n次放弃后终于在本地配置好了LaTeX环境，成就感与幸福感溢于言表！特写此文，希望能够分享整个过程，帮助更多需要的人。