vscode编译Latex配置

原本是不想写 latex 本地环境配置的文章的,因为网上已经有很多相关的博客和文章。但是师妹在配置 vscode 时复制了网上错误的配置导致 bib 半天编译不过,并难以定位问题。因此,写下本篇配置说明来维护一个正确的配置,避免未来再出现类似的问题。

放一盆王八在这

Latex 环境配置

  1. 下载 latex 编译工具,这里建议使用 texlive

  2. 安装包下载完成后点击安装即可

  3. 确认安装,在 texlive 安装完成后,在命令行里输入 tex,得到结果如下,则说明系统环境变量配置成功

vscode 配置

  1. 安装插件 latex-workshop

  2. Ctrl+Shift+P 输入 open user settings 打开用户配置文件 settings.json

  3. 向用户配置文件 settings.json 中添加如下内容

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97
    98
    99
    100
    101
    102
    103
    104
    "latex-workshop.latex.tools": [
    {
    "name": "latexmk",
    "command": "latexmk",
    "args": [
    "-synctex=1",
    "-interaction=nonstopmode",
    "-file-line-error",
    "-pdf",
    "%DOC%"
    ]
    },
    // 这里是xelatex工具的定义
    {
    "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",
    "%DOC%"
    ]
    },
    {
    "name": "bibtex",
    "command": "bibtex",
    "args": [
    "%DOCFILE%"
    ]
    },
    {
    "name": "biber",
    "command": "biber",
    "args": [
    "%DOCFILE%"
    ]
    },
    ],
    //设置编译链的时候使用xelatex作为默认的第一个首选编译
    "latex-workshop.latex.recipes": [
    {
    "name": "pdflatex -> bibtex -> pdflatex",
    "tools": [
    "pdflatex",
    "bibtex",
    "pdflatex"
    ]
    },
    {
    "name": "pdflatex -> biber -> pdflatex",
    "tools": [
    "pdflatex",
    "biber",
    "pdflatex"
    ]
    },
    {
    "name": "pdflatex",
    "tools": [
    "pdflatex",
    ]
    },
    {
    "name": "xelatex",
    "tools": [
    "xelatex"
    ]
    },
    {
    "name": "latexmk",
    "tools": [
    "latexmk"
    ]
    },

    {
    "name": "pdflatex -> bibtex -> pdflatex*2",
    "tools": [
    "pdflatex",
    "bibtex",
    "pdflatex",
    "pdflatex"
    ]
    },
    {
    "name": "xelatex -> bibtex -> xelatex*2",
    "tools": [
    "xelatex",
    "bibtex",
    "xelatex",
    "xelatex"
    ]
    }
    ],
  4. 打开一个 *.tex 文件,左侧出现 TEX 图标说明配置成功