本文已于2020.11.23修改

什么是Latex？

LaTeX（LATEX，音译“拉泰赫”）是一种基于ΤΕΧ的排版系统，由美国计算机学家莱斯利·兰伯特（Leslie Lamport）在20世纪80年代初期开发，利用这种格式，即使使用者没有排版和程序设计的知识也可以充分发挥由TeX所提供的强大功能，能在几天，甚至几小时内生成很多具有书籍质量的印刷品。对于生成复杂表格和数学公式，这一点表现得尤为突出。因此它非常适用于生成高印刷质量的科技和数学类文档。这个系统同样适用于生成从简单的信件到完整书籍的所有其他种类的文档。——百度百科

latex并不是工具的名字

我需要做什么？

1. 安装visual studio code（巨硬出品）
2. 安装编译器。目前有MikTeX等。似乎vscode对MikTeX支持比较自然，我建议安装MikTeX。直接到MikTeX官方网站下载安装。
3. 我们需要在系统环境变量的Path中添加MikTeX的路径C:\Program Files\MiKTeX 2.9\miktex\bin\x64\。这里我把MikTeX安装在了默认路径下。
4. 安装perl。这是一个脚本解释器（interpreter）。在安装过程中也需要勾选添加到Path。
5. 打开vscode，安装Latex-workshop插件。
6. 随便创建一个.tex文件，里面输入

   \documentclass{article}
   % 这里是导言区
   \begin{document}
   Hello, world!
   \end{document}
   

7. 在左侧栏中找到TEX按钮，可以看到build LaTeX project里有多个预设好的Recipe,点击那个latexmk，就可以执行编译。
8. 在当前目录下就可以找到对应输出的pdf。

额外的设置

在vscode的setting.json里添加一些额外配置。包括自动编译、自动清理等等。

"latex-workshop.latex.autoBuild.run": "never",
"latex-workshop.view.pdf.viewer": "tab",
"latex-workshop.latex.autoClean.run": "onBuilt"

【formtter这个没有测试好】还可以设置formatter：latexindent。点击这里。formatter需要perl安装Log::Log4perl.pm包。安装之前修改一下perl原生的员，我改成了网易的镜像。修改C:\Perl64\lib\CPAN\Config.pm中的urllist字段为

'urllist' => [q[http://mirrors.163.com/cpan/]],

点击官方说明查看最新方法。修改好后，在powershell中运行cpan，再运行

cpan> install Log::Log4perl.pm

【重要】vscode setting.json主要代码如下：

	{
    "latex-workshop.latex.autoBuild.run": "never",
    "latex-workshop.view.pdf.viewer": "tab",
    "latex-workshop.latex.autoBuild.cleanAndRetry.enabled": false,
    "latex-workshop.latex.recipes": [
        {
            "name": "sjtu thesis ?",
            "tools": [
                "cleanall",
                "latexmk",
                "clean"
            ]
        },
        {
            "name": "xelatex ?",
            "tools": [
                "xelatex"
            ]
        },
        {
            "name": "bibtex ?",
            "tools": [
                "bibtex"
            ]
        },
        {
            "name": "pdflatex ➞ bibtex ➞ pdflatex`×2",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        }
    ],
    "latex-workshop.latex.tools": [
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-halt-on-error",
                "%DOC%"
            ],
            "env": {}
        },
       {
            "name": "xelatex",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOC%"
            ]
        },
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        },
        {
            "name": "clean",
            "command": "latexmk",
            "args": [
                "-quiet",
                "-c",
                "%DOC%"
            ]  
        },
        {
            "name": "cleanall",
            "command": "latexmk",
            "args": [
                "-quiet",
                "-C",
                "%DOC%"
            ]  
        }
    ],
    "terminal.integrated.shell.windows": "C:\\Program Files\\PowerShell\\7\\pwsh.exe"
}

工具的版本