Windows 下 VSCode + Latex 的集成使用

本文将简单介绍 Windows 下 VSCode + Latex 的集成使用的环境配置过程。

textlive 安装

本地安装 texlive ，安装过程比较简单，不做赘述

配置 textlive 环境变量

安装完成texlive之后，配置系统环境变量。如：本地安装 texlive 的路径为：D:\texlive\2018\bin\win32，将其添加到系统环境变量Path中

VSCode 安装

安装 VSCode ，安装过程比较简单，不做赘述

插件 latex-workshop 安装

安装 VSCode 插件 latex-workshop。点击左侧的扩展图标或者使用快捷键ctrl+shift+x，输入latex workshop，点击安装。

配置 latex-workshop

"latex-workshop.view.pdf.viewer": "tab",
"latex-workshop.latex.recipes": [
    {
        "name": "pdflatex",
        "tools": [
            "pdflatex"
        ]
    },
    {
        "name": "bibtex",
        "tools": [
            "bibtex"
        ]
    },
    {
        "name": "latexmk",
        "tools": [
            "latexmk"
        ]
    },
    {
        "name": "pdflatex -> bibtex -> pdflatex*2",
        "tools": [
            "pdflatex",
            "bibtex",
            "pdflatex",
            "pdflatex"
        ]
    }
],
"latex-workshop.latex.tools": [
    {
        "name": "xelatex",
        "command": "xelatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    },
    {
        "name": "latexmk",
        "command": "latexmk",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-pdf",
            "%DOC%"
        ]
    },
    {
        "name": "pdflatex",
        "command": "pdflatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    },
    {
        "name": "bibtex",
        "command": "bibtex",
        "args": [
            "%DOCFILE%"
        ]
    }
],
"latex-workshop.latex.clean.enabled": true,
"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"
]

编写 tex 文档

以上配置完成即可开始编辑tex文档。打开.tex文件，右键选择编译，或者ctrl+alt+b，编译完成点击预览即可。

注意事项

• 以上配置，使用pdflatex编译，可以支持中文文件名，使用xelatex就不行了。
• 如果tex文档中包含中文字符，会编译出错，报Recipe terminated with error.，可以如下处理，在文章头部加入\usepackage[UTF8]{ctex}：

  \documentclass{article}
      %支持中文
      \usepackage[UTF8]{ctex}
      \begin{document}
      Hello, world!
  
      你好，世界！
      \end{document}