使用VSCode编写LaTeX

1 概述

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

  VSCode是微软在2015年4月30日Build 开发者大会上正式宣布发行的一个运行于 Mac OS X、Windows和 Linux 之上的，针对于编写现代 Web 和云应用的跨平台源代码编辑器。

vscode功能完善而强大，基本作为不用IDE时首选代码编辑器，用vscode来编写LaTeX文档，也应当是有极佳的体验的。本文是以windows为例讲述安装配置过程，如果用linux操作也是类似的，故不再详述。

2 安装

TeX Live

常用的TeX编译器有两种， TeXLive 和 MiKTeX 。前者大而全（接近6GB），后者则相对小巧玲珑。因为我的硬盘空间比较大，这里我们采用了大而全的TeX Live。

TexLive常规安装需要一边下载一边安装（即网络安装板），非常考验网速。所以可以下载完整的ISO文件，打开后， 找到文件’install-tl-windows.bat’，右键选择“以管理员身份运行”，建议选择完整安装，整个安装过程大概耗时半个到一个小时不等。同时也可以选择’install-tl-advanced.bat’，只勾选那些需要的功能，减少硬盘占用大小。

上图则是常规安装在线下载所需软件包的截图，我全部勾上了共三千多个包，要安装一段时间去了。这段时间就可以继续安装配置vscode了。

另外，安装完成之后，记得去看一下环境变量中有没有关于Tex Live相关的变量，没有添加一下即可。

VSCode

VSCode安装不介绍了。但这里需要用到vscode的一个插件——
LaTeX Workshop 。

打开VS Code，点击左下角扩展选项或者Ctrl+Shift+X打开扩展库搜索LaTeX，点击LaTeX Workshop安装。

3 配置

如果之前已经添加了环境变量，那么这里就不用配置，直接使用就可以啦！

如果因人品问题，需要手动配置的， 可参考以下方法：

1、把texlive安装路径的bin\win32加入环境变量 (linux用户想.bashrc中加入export PATH=”/path/to/texlive/bin:$PATH”)

2、进入VSCode的“文件->首选项->设置”，搜索latex，出现如下结果：

对选项’latex-workshop.latex.toolchain’进行修改，按照如下设置：

 "latex-workshop.latex.toolchain": [
     {
       "command": "pdflatex",
       "args": [
         "-synctex=1",
         "-interaction=nonstopmode",
         "-file-line-error",
         "%DOC%"
       ]
     }
]

4 使用

• 右键对.tex进行编译(快捷键：crtl+alt+b)
• 生成PDF文件，上图中的预览按钮(快捷键：crtl+alt+v)
• 从pdf跳转到tex文件，crtl+左键+所选文字

其他设置

• LaTeX Workshop默认保存的时候编译，如果不喜欢这个设置，可以添加以下代码进入设置区：

"latex-workshop.latex.autoBuild.onSave.enabled": false,

• latex-formatter是一款用于格式化  代码的插件，有需要可以安装。

• 想要让LaTex编译器支持中文，必须要在.tex文件的开头加上：

\usepackage[UTF8]{ctex}

• 由于LaTex编译过程会产生一些辅助文件，放在那没什么用，看着也糟心，所以可以设置在生成pdf之后删除辅助文件。下面配置中，第一个参数是指定在PDF文件生成后自动清除辅助文件，第二个参数是在原来的基础上加上了”*.gz”，因为按照默认的清除设置，最后还会留下一个.gz的文件，对于Windows环境来说好像没什么用，故一并清除之。

"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",
  "*.gz"
]

参考：

Win10下 VS code+LaTeX 环境的构建

Windows下VSCode+LaTex中文环境配置

使用VSCode编写LaTeX

在Win下愉快的使用VS Code+LaTeX