Visual Studio Code 折腾记：LaTeX 集成编辑环境Visual Studio Code 是微软推出的一款开源编辑器，一般简称为 VSCode。相较于收费的 Sublime Text、奇慢无比的 Github Atom，VSCode 在我看来是 Windows 平台上最合我胃口的编辑器了。虽然扩展插件没有那么丰富，对我来说也是完全够用了。试过 VSCode 之后，果断把主力编辑器换成了 VSCode。接下来大概会有一系列文章讲讲我折腾 VSCode 的事情。
LaTeX 是现在最流行的科技写作工具，是最棒的文档排版系统之一。LaTeX 有很多的 IDE，但主流的 TeXworks 太过于简单了、TeXStudio 在 Windows 下的显示有非常糟糕。把 VSCode 配置成 LaTeX 的 IDE 用起来就非常舒服了。
本文中使用的软件版本为：
- TeX Live 2018-20180414
- Visual Studio Code 1.28.2
- LaTeX Workshop 5.13.0
主版本号不同的 LaTeX Workshop 的配置文件可能会有较大差异，早先（2017 年及以前）的配置文章很可能已经失效。
软件安装
- LaTeX 发行版：TeX Live、MikTeX 或者 CTeX
- Visual Studio Code
- LaTeX Workshop
LaTeX 发行版的安装
LaTeX 国内用户主要使用的发行版基本上集中在 TeX Live 和 CTeX 上，任选一个安装即可。
TeX Live 的安装
Tex Live 可以从它的官网上下载：Tex Live - Tex Users Group（这官网真的简陋）。
由于国内的网络环境，网络安装会非常缓慢，建议选择 other methods 中的 Downloading one huge ISO file。之后可以手动从景象列表里面选择一个比较近的景象下载即可。其中 texlive.iso 是最新版本。
这里给出清华开源镜像站的地址：texlive.iso
Windows 10 下可以双击直接挂载 ISO 镜像，之后运行其中的 install-tl-windows.bat 就可以启动安装程序，TeXWorks 可以不用安装。
之后需要将 C:\texlive\2018\bin 添加到 PATH 变量中。
CTeX 的安装
CTeX 同样从它的官网上下载：Welcome to Chinese TeX:CTEX。
这里给出清华开源镜像站的地址：CTeX_2.9.2.164_Full.exe
直接双击运行安装就好，可以不需要安装 LaTeX 的 IDE，注意选择要将 CTeX 添加到 PATH 变量。
Visual Studio Code 与 LaTeX Workshop 的安装
Visual Studio Code 的官网是：Visual Studio Code - Code Editing. Redefined。
安装 Visual Studio Code 时根据需要选择一些选项：
- 将 Code 添加到右键菜单
- 将 Code 注册为可用编辑器
- 将 Code 添加到 PATH
安装完成后，点击左侧扩展按钮（KEY: Ctrl+Shift+X），搜索 LaTeX Workshop，选择安装、重新加载即可。
编译模式配置
使用可变 TeX 引擎 / TeX 魔术命令
编写 LaTeX 文件时有两个魔术命令（Magic comments）：% !TEX root 和 % !TEX program，前者指定 LaTeX 根文件，后者制定编译方式。新版本的 LaTeX Workshop，默认支持魔术命令，无需配置。高度建议使用魔术命令来制定编译方式。
% !TEX program = xelatex% !TEX root = relative/or/absolute/path/to/root/file.tex
添加编译工具
LaTeX Workshop 默认包含了几种编译工具，对中文用户来说一般需要把 XeLaTeX 添加进去。
点击左下角设置图标，选择设置，打开settings.json，在右侧添加下面的代码：
"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%"]}],
添加编译方案
相应的，我们还需要添加一些编译方案。
点击左下角设置图标，选择设置，打开settings.json，在右侧添加下面的代码：
"latex-workshop.latex.recipes": [{"name": "XeLaTeX","tools": ["xelatex"]},{"name": "PDFLaTeX","tools": ["pdflatex"]},{"name": "latexmk","tools": ["latexmk"]},{"name": "BibTeX","tools": ["bibtex"]},{"name": "pdflatex -> bibtex -> pdflatex*2","tools": ["pdflatex","bibtex","pdflatex","pdflatex"]},{"name": "xelatex -> bibtex -> xelatex*2","tools": ["xelatex","bibtex","xelatex","xelatex"]}],
使用项目任务文件（tasks.json）
这个我暂时没有尝试，请参考：Visual Studio Code 搭建 LaTeX 编写环境 | Ethlisan
其他的一些配置
其他有一些细小的配置需要调整：
"latex-workshop.view.pdf.hand": true, // 预览 PDF 文件时默认使用手型工具"latex-workshop.latex.autoBuild.onSave.enabled": false, // 关闭保存时自动编译"latex-workshop.synctex.afterBuild.enabled": true, // 启用反向搜索 （在 PDF 预览器中按下 Ctrl + ←，同时鼠标点击要反向搜索的位置）
愉快地使用
配置（调教）Visual Studio Code 和 LaTeX Workshop 基本告一段落，现在就让我们愉快地玩耍吧！
侧边栏
LaTeX Workshop 提供了侧边栏组件。打开 LaTeX 文件后，可以点击左边的 TeX 按钮，就可以打开侧边栏。
侧边栏提供了 LaTeX Workshop 提供的大部分命令，包括所有的编译方案等等。几乎所有的 IDE 功能都集中在了这里。
侧边栏同时也提供了 LaTeX 文件的结构树，这一下基本上和一般的 LaTeX IDE 无差了。
命令面板与快捷键
Visual Studio Code 提供的命令面板可通过在任意地方单机右键、选择命令面板打开（KEY: Ctrl + Shift + P），在命令面板中也可使用 LaTeX Workshop 提供的大部分命令。在命令面板中输入 LaTeX Workshop 就可以看到所有的命令，在命令旁边就可以看到快捷键。
LaTeX Workshop 的常用快捷键：
Ctrl + Alt + B：编译Ctrl + Alt + C：清除 auxiliary 文件Ctrl + Alt + J：定位跳转到光标所在位置对应的 PDF 文件位置Ctrl + Alt + V：打开 PDF 预览
有的人可能觉得快捷键不好用，可以自己调整。
正向和反向定位跳转
LaTeX Workshop 提供了正向和反向定位跳转功能：
机械键盘中的win 等同于mac键盘上的command
即 复制粘贴为： win + c / command + c ； win + v / command + v
- 在 LaTeX 文件中，机械键盘：
win + alt + J跳转到对应的 PDF 文件位置。 - 在 PDF 文件中，跳转到对应的 LaTeX 文件位置。 机械键盘：
win +触摸盘单点一下
反向跳转比较奇葩，经常跳转到 LaTeX 文件后会会激活 Ctrl + ← 的另一项功能——跳转到上一单词……
参考资料
- James-Yu/LaTeX-Workshop: README https://github.com/James-Yu/LaTeX-Workshop
- Visual Studio Code 搭建 LaTeX 编写环境 | Ethlisan http://ddswhu.com/visual-studio-code-latex/
- 如何配置 Visual Studio Code 作为 LaTeX 编辑器 http://www.latexstudio.net/archives/12260.html
- Visual Studio Code 搭建 LaTeX 编写环境 http://ddswhu.com/visual-studio-code-latex/
- 使用VSCode编写LaTeX - 知乎 https://zhuanlan.zhihu.com/p/38178015
本文链接：https://blog.ceba.tech/2018/11/Visual-Studio-Code-LaTeX/
1723
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
