VSCode配置latex环境，报错怎么办？

卸载MiKTeX，安装TeXLive，一劳永逸不用担心缺少什么宏包，建议使用命令行编译，latexmk编译命令比起手动输入四次编译命令好多了。命令如下:

latexmk -xelatex -synctex＝1 -interaction＝nonstopmode filename.tex

入门请读install-latex-guide-zh-cn以及lshort。

安装方法

1、在Ubuntu安装LaTeX的编译器xelatex、中文字体等必需软件

$ sudo apt-get update
$ sudo apt-get install texlive-latex-base latex-cjk-all texlive-latex-extra texmaker texlive-xetex texlive-publishers

2、安装LaTeX的VS Code插件 打开VS Code的“插件”（Extensions），搜索框搜索“LaTeX Workshop”，并安装

3、配置编译器

①点击小齿轮，点击“插件设置”（Extension Settings），并搜索latex-workshop.latex.recipes

②点击“编辑setting.json”（Edit in settings.json），添加以下内容，并保存

    "latex-workshop.latex.recipes": [
        {
        "name": "xelatex",
        "tools": [
          "xelatex"
        ]
        },
        {
        "name": "xelatex->bibtex->exlatex*2",
        "tools": [
          "xelatex",
          "bibtex",
          "xelatex",
          "xelatex"
        ]
      }],

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

③重启VS Code后，即可正常编译 点击该绿色三角形，即可编译

点击左侧TeX，并点击View in VSCode tab，即可在编辑窗右侧查看PDF。

注意事项

1、本教程适用于VS Code-Remote SSH（服务端为Linux）、Code-Server（二进制安装，Docker未测试），但这两个平台在使用过程中会遇到以下问题： \ Remote SSH： 点击View in VSCode tab后，空白无法正常显示PDF。 原因：简单来说，VS Code的端口转发有bug https://github.com/James-Yu/LaTeX-Workshop/issues/2206

解决： 法①：由GitHub用户提供的临时解决方法，先点击View in web browser，待正常载入后，即可再次点击View in VSCode tab，即可恢复正常。但退出VS Code后，该问题会重现。该问题可能会在VS Code更新后得到解决。

法②：安装vscode-pdf插件，虽然会弹出“LaTeX Workshop与vscode-pdf插件不兼容”的提醒，实测无影响，LaTeX Workshop的View in VSCode tab也能正常显示pdf。

Code-Server： 同Remote SSH问题①，而解决方法只有法②

法：安装vscode-pdf插件，虽然会弹出“LaTeX Workshop与vscode-pdf插件不兼容”的提醒，实测无影响，LaTeX Workshop的View in VSCode tab也能正常显示pdf。

2、使用vscode-pdf插件时，可能不会正常显示中文 原因：vscode-pdf可能在编译时只支持Windows自带中文字体，不支持Ubuntu/macOS自带中文字体。

解决： 参考：Ubuntu安装Windows字体，并在.tex文件修改如下(以ctex字体为例)

\usepackage[fontset=windows]{ctex}

3、可设置成自动编译+动态更新显示pdf，实时查看最新pdf，无需手动点击编译 方法： ①进入设置

②搜索“auto save”，将Files: Auto Save改为“afterDelay”

其余设置如：Files: Auto Save Delay（1000ms后自动保存，可适当调小或调大）、Latex-workshup>Latex>Auto Bulid: Run（默认为onFileChange，即文件更改时自动编译）一般保持默认即可。

4、输入中文时选择字体如\songti、\kaiti时，会有warnings

解决：实际上不影响使用，只是弹出warnings有点令人烦躁。解决方法同注意事项2，且以下字体如\songti、 \heiti、\yahei、\fangsong、\kaishu（Windows下楷体的英文为kaishu，Linux/macOS下为kaiti）不会有warnings，\youyuan还是会有warnings。