LaTex 学习 LaTex神器：Visual Studio Code
Posted 沧夜2021
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了LaTex 学习 LaTex神器：Visual Studio Code相关的知识，希望对你有一定的参考价值。
前言
上文我们提到了LaTex与Tex的关系与渊源。
LaTex学习（一） 为什么我要这样安装LaTex？_沧夜2021-CSDN博客
这次我们来学习如何使用Visual Studio Code来写LaTex
Visual Studio Code简介
Visual Studio Code是一个可以在你的桌面运行的轻量强大的代码编辑器，支持Windows、macOS 和 Linux。它不仅提供对 javascript、TypeScript 和 node.js 的支持，还具有丰富的语言扩展（如C++、C#、Java、Python、php、Go）
现阶段有很多人使用它和其他网盘结合搭建自己的笔记系统，总之是各种花式折腾，而且还折腾得很好看。
Visual Studio Code安装
点击Visual Studio Code进入官网，我们可以看到那对比鲜明的Download for Windows按钮。
但是…
不要点击下载！
不要点击下载！
不要点击下载！
如果你下载以管理员权限安装你会发现这个问题
这个安装包是仅给当前用户安装的版本。不能够自定义安装路径。我们需要安装系统安装版本！
在Visual Studio Code官网界面往下拉
点击Windows徽标下的System Installer 64 bit 按钮，现在的电脑基本都是64位…吧？
我们下载64位的系统安装版本
下载完成后放心地双击安装
同意协议
这里就有选择自己的安装路径了。根据自己的需要选择自己安装路径即可
点击下一步
上面的可以全选，然后点击下一步
最后点击安装即可
SumatraPDF的安装
VSCode 需要使用SumatraPDF作为LaTex的预览，这个软件打开速度较快。适合搭配VSCode
下载链接：
Download Sumatra PDF - a free reader (sumatrapdfreader.org)
点击64位的SumatraPDF-3.2-64-install.exe即可
这个软件就不做安装步骤了。安装完成后先放一边。接下来继续安装VSCode插件
Visual Studio Code插件安装
以下建议安装几个插件
chinese中文插件
打开VSCode点击左侧的四个正方形的图标，这个图标是拓展选项卡，然后再搜索框里输入chinese，显示出图中这么多的拓展候选后，点击安装第一个插件即可。安装好后，重启VSCode就会变成汉化桌面了
LaTeX Workshop插件
LaTeX Workshop插件是使用Visual Studio Code写LaTex的必要插件。
同上，在拓展的搜索框搜索LaTeX Workshop，检索第一位就是LaTeX Workshop,点击安装即可
Visual Studio Code配置
接下来的LaTeX Workshop插件的配置是这篇文章的重头戏。我们可以看到网络上有很多方案可以拿来抄。但是我还是希望能够讲清楚，为什么要这样写。
在VSCode页面选项卡找到查看——>命令面板
输入settings.json
按提示选择打开设置
可以看到这是一个空白的文件
我们需输入以下代码：
{
"latex-workshop.latex.tools": [ //编译工具设定
{
"name": "xelatex",
"command": "xelatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"-pdf",
"%DOCFILE%" // 把 %DOC% 替换为 %DOCFILE% 就可以支持中文路径下的文件
]
},
{
"name": "latexmk",
"command": "latexmk",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"-pdf",
"%DOCFILE%"
]
},
{
"name": "pdflatex",
"command": "pdflatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOCFILE%"
]
},
{
"name": "bibtex",
"command": "bibtex",
"args": [
"%DOCFILE%"
]
}
],
"latex-workshop.latex.recipes": [ //编译组合设定
{
"name": "xelatex", //单xelatex编译
"tools": [
"xelatex"
]
},
{
"name": "latexmk", //latexmk编译
"tools": [
"latexmk"
]
},
{
"name": "pdflatex -> bibtex -> pdflatex ×2", //组合编译
"tools": [
"pdflatex",
"bibtex",
"pdflatex",
"pdflatex"
]
}
],
// 使用sumatraPDF
"latex-workshop.view.pdf.viewer": "external",
//[此处一行为注释]下面一行引号里输入自己SumatraPDF安装位置
"latex-workshop.view.pdf.external.viewer.command": "C:/software/SumatraPDF/SumatraPDF.exe",
"latex-workshop.view.pdf.external.viewer.args": [
"%PDF%"
],
//[此处一行为注释]下面一行引号里输入自己SumatraPDF安装位置
"latex-workshop.view.pdf.external.synctex.command": "C:/software/SumatraPDF/SumatraPDF.exe",
"latex-workshop.view.pdf.external.synctex.args": [
"-forward-search",
"%TEX%",
"%LINE%",
"-reuse-instance",
"-inverse-search",
//[此处一行为注释]C:\\\\software\\\\Microsoft VS Code是VScode安装文件夹，\\\\是转义
"code \\"C:\\\\software\\\\Microsoft VS Code\\\\resources\\\\app\\\\out\\\\cli.js\\" -r -g \\"%f:%l\\"",
"%PDF%",
],
// 清空中间文件
"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",
"*.bcf",
"*.run.xml",
"*.synctex.gz"
],
}
这次还是需要翻阅官方文档
Compile · James-Yu/LaTeX-Workshop Wiki (github.com)
这次文档有点儿多，就不一遍遍带着过了。主要是latex-workshop.latex.tools与latex-workshop.latex.recipes两个设定
latex-workshop.latex.tools是设定的编译工具
latex-workshop.latex.recipes是设定的编译流程
latex-workshop.view.pdf.viewer设定pdf的预览方式，这里我们设定SumatraPDF为pdf预览的软件
latex-workshop.latex.clean.fileTypes用于清除某些类型的文件
注意，上面的代码配置内容中，有几处需要根据自己SumatraPDF和VScode安装路径修改
// 使用sumatraPDF
"latex-workshop.view.pdf.viewer": "external",
//[此处一行为注释]下面一行引号里输入自己SumatraPDF安装位置
"latex-workshop.view.pdf.external.viewer.command": "C:/software/SumatraPDF/SumatraPDF.exe",
"latex-workshop.view.pdf.external.viewer.args": [
"%PDF%"
],
//[此处一行为注释]下面一行引号里输入自己SumatraPDF安装位置
"latex-workshop.view.pdf.external.synctex.command": "C:/software/SumatraPDF/SumatraPDF.exe",
"latex-workshop.view.pdf.external.synctex.args": [
"-forward-search",
"%TEX%",
"%LINE%",
"-reuse-instance",
"-inverse-search",
//[此处一行为注释]C:\\\\software\\\\Microsoft VS Code是VScode安装文件夹，\\\\是转义
"code \\"C:\\\\software\\\\Microsoft VS Code\\\\resources\\\\app\\\\out\\\\cli.js\\" -r -g \\"%f:%l\\"",
"%PDF%",
],
上面的
"latex-workshop.view.pdf.external.viewer.command": "C:/software/SumatraPDF/SumatraPDF.exe",
与
"latex-workshop.view.pdf.external.synctex.command": "C:/software/SumatraPDF/SumatraPDF.exe",
中的C:/software/SumatraPDF/SumatraPDF.exe改为自己SumatraPDF的安装路径
"code \\"C:\\\\software\\\\Microsoft VS Code\\\\resources\\\\app\\\\out\\\\cli.js\\" -r -g \\"%f:%l\\"",
中的C:\\\\software\\\\Microsoft VS Code改为自己的VScode安装路径，记得路径分隔符是\\\\而不是/
以上步骤完成后。
还有最后一步。SumatraPDF的配置
SumatraPDF配置
打开SumatraPDF，点击软件选项卡上方的三个黑色横杠
点击设置——>选项
在最下面的反向搜索命令行中输入
"C:\\software\\Microsoft VS Code\\Code.exe" "C:\\software\\Microsoft VS Code\\resources\\app\\out\\cli.js" -g "%f":%l
记得将C:\\software\\Microsoft VS Code替换成自己的VSCode安装目录，注意这里有两处需要替换。
然后点击确定。至此，VSCode配置完毕
Visual Studio Code测试
按要求配置好后，打开VSCode新建文件，在编辑框输入以下latex测试代码
\\documentclass{article}
\\begin{document}
hello,world
\\end{document}
按下键盘组合键Ctrl+S保存并命名为1.tex，只要结尾是.tex即可。名称随意
接下来我们可以看到拓展选项图标下面新增了一个TEX图标
点击TEX图标，可以看到编译命令COMMANDS
COMMANDS命令部分简介如下：
Build LaTex project
Clean up auxiliary files //清理辅助文件
Terminate current compilation //终止当前编译
Recipe:xelatex //xelatex编译
Recipe:latexmk //latexmk编译
Recipe:pdflatex -> bibtex -> pdflatex ×2 //pdflatex -> bibtex -> pdflatex ×2编译
View LaTex PDF
View in VSCode tab //在VSCode选项卡浏览
View in web brower //在浏览器浏览
View in external viewer //在外置浏览器浏览
Set default viewer //设定默认浏览
Refresh all viewers //刷新浏览
View Log messages //查看信息记录
......
以上我们可以看到Build LaTex project里的Recipe的显示就是我们VSCode配置里的latex-workshop.latex.recipes的内容
接下来我们可以点击Recipe:xelatex或Recipe:latexmk实现编译。并点击View LaTex PDF里面View的方式浏览即可
以上是LaTex学习过程中，较为复杂的VSCode配置相关简述。
当然，即使看了这篇文章，我也不能保证你能够完全安装正确，或许是漏看我的内容又或许是输入错了代码，亦是由于不同的电脑环境，软件环境出错。如果出错，欢迎在评论下方留言，我们一起解决。
以上是关于LaTex 学习 LaTex神器：Visual Studio Code的主要内容，如果未能解决你的问题，请参考以下文章
latex排版神器——Mathtype和Excel2LaTeX
[转]免费数学神器！再复杂的公式，只要有照片就能转成LaTeX
强大！一键转换LaTex公式，这款开源公式识别神器比Mathpix Snip更适合你