VSCode编写latex

个人微信公众号：J平方

0 写在前面

由于latexe相关软件的编辑界面不太舒服，加上笔者钟情于VSCode，而网上没有一个简单易用的VSCode搭建教程，故有此书。
本博客的后续补充参见 VSCode+latex引用bibtex参考文献。

1 安装Latex环境

Latex环境即Tex Live，见参考链接1.1
不同系统有不同的版本，并且还有完整版和简化版，这里给出全是不同系统完整版的传送门
MacTex下载链接
WIN上texlive可以现在在线安装版，也可以下载离线安装iso版本，由于网速问题，推荐下载离线iso的镜像
texlive iso清华镜像下载
texlive iso安装教程

2 LaTeX Workshop

这是VSCode上的插件，找到安装即可，VSCode如何安装插件自查

3 设置settings.json(针对中文)

mac参考链接
win参考链接
以上给出两个关于配置VSCode内settings.json的参考链接，实际上不管什么系统，配置都是一样的，如下：
快捷键cmd(ctrl)+shift+p输入setting打开settings.json把以下代码加入，注意在原本内容的最后一行加上英文逗号换行再复制粘贴，不然会报错

此外如果需要支持中文路径下的文件，需要把以下内容中的%DOC%改为%DOCFILE%"，但此处笔者建议涉及代码方面不要用中文路径

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

4 demo

在 英文 路径下新建一个.tex文件，输入代码如下，注意首行\documentclass[UTF8]{ctexart} 用于支持中文

\documentclass[UTF8]{ctexart} 
\title{你好，world!}
\author{Winston}
\date{\today}
\begin{document}
\maketitle
你好，world！
\end{document}

然后cmd(ctrl)+s保存编译，就会生成.aux、.pdf等文件，注意保存的过程同时也是编译的过程，然后打开右上角预览就会看到生成的pdf