环境配置——VS code + MiKTeX + SumatraPDF使用LaTeX

参考内容1
参考内容2
参考内容3
参考内容4

通过VS code、MiKTeX和SumatraPDF实现LaTeX编辑。

 

1.Visual Studio code

下载链接：VS Code官网

我这里的VS Code是已经安装好的，不需要再下载。详细安装过程可以参考：VS Code安装过程

安装完成后，在VS Code中查找并安装插件：

Figure 1 LaTeX Workshop安装

 

2.MiKTeX

下载链接：MiKTeX官网

下载好后双击exe程序安装，选择个人（only for me）。

安装完成后配置系统环境变量，按照Figure 2们的顺序配置：我的电脑（右键 属性），右侧选择高级系统设置$\to$ 点击环境变量$\to$ 选择到系统变量的Path，双击进入$\to$ 选择到miktex对应安装的文件位置（如图）（如果环境变量自动配置了则不需要再配置）。

Figure 2 配置环境变量

 

完成配置后，VS code可以直接找到MiKTeX，并对.tex文件进行编译。

中间可能存在个问题，提示没有perl：

MiKTeX could not find the script engine 'perl.exe' which is required to execute 'latexmk'.

因此需要在下载perl，下载链接：perl官网。选择download and get started，根据不同系统选择对应的安装包，windows环境下选择Strawberry Perl就行：

Figure 3 Perl 下载官网

 
安装以后重启VS Code，应该就可以使用了。perl安装教程来源百度经验。

新建.tex文件用以下代码可以尝试编译。在VS Code中，点击右上角几个键可以实现.tex文件的编译和pdf的查看。在编译过程中，可能会弹出提示某些文件不存在，选择安装即可。

\documentclass[utf8]{ctexart}
\title{测试}
\author{wyx}
\date{2021.4.30}
\begin{document}
    \maketitle
    应该可以了
\end{document}

Figure 4 VS code编译界面

 

以上就完成了所有的配置。如果需要SumatraPDF，则请继续往下看。

 

3.SumatraPDF

下载链接：SumatraPDF下载

根据需要选择对应的版本进行下载（官网好像有点丑）：

Figure 5 SumatraPDF下载网站

 

安装完成后，需要在VS Code上进行配置文件。想尽一切办法打开setting.json文件，进行配置：VS Code界面，打开设置 $\to$ 选择设置右上角的按钮转换成setting.json $\to$ 配置json文件。

Figure 6 配置setting.json文件

 

将以下代码添加setting.json文件中。需要注意的是第11、16行将位置修改到sumatraPDF安装的位置（sumatraPDF.exe所在位置）。倒数第三行中，把位置修改到VS Code所在位置（Code.exe的位置），后面一半也是（参考：参考内容4）。（有的教程中添加了一大串的代码，我一开始没有加。在编译了一次LateX文档以后，那些设置的代码好像会自动添加。）

     // 右键菜单
    "latex-workshop.showContextMenu":true,         
     // 根据加载的包，自动完成命令或包       
  	"latex-workshop.intellisense.package.enabled": true, 
  	// 禁止保存文件时自动build  
  	"latex-workshop.latex.autoBuild.run": "never",        
    // 设置预览方式
    "latex-workshop.view.pdf.viewer": "external",
    "latex-workshop.view.pdf.ref.viewer":"external",
    // 设置外部PDF预览器
    "latex-workshop.view.pdf.external.viewer.command": "D:/Program/SumatraPDF\\SumatraPDF.exe",
    "latex-workshop.view.pdf.external.viewer.args": [
        "%PDF%"
    ],
    // 设置正向搜索
    "latex-workshop.view.pdf.external.synctex.command": "D:/Program/SumatraPDF\\SumatraPDF.exe",
    "latex-workshop.view.pdf.external.synctex.args": [
      "-forward-search",
      "%TEX%",
      "%LINE%",
      "-reuse-instance",
      "-inverse-search",
      "\"C:/Users/wyx/AppData/Local/Programs/Microsoft VS Code\\Code.exe\" \"C:/Users/wyx/AppData/Local/Programs/Microsoft VS Code\\resources\\app\\out\\cli.js\" -r -g \"%f:%l\"",
      "%PDF%"
    ],

在设置完正向搜索后，设置反向搜索：界面左上角三杠，选择设置 $\to$ 选项 $\to$ 红框位置，修改为上面代码中VS Code所在位置：

"C:/Users/wyx/AppData/Local/Programs/Microsoft VS Code\\Code.exe\" \"C:/Users/wyx/AppData/Local/Programs/Microsoft VS Code\\resources\\app\\out\\cli.js\" -r -g \"%f:%l\"

Figure 7 配置SumatraPDF

 

通过以上配置，可以实现pdf到代码、代码到pdf的双向定位。在SumatraPDF中，双击pdf对应的文字，可以定位到代码；将光标放在VS Code的文字上，快捷键ctrl + alt + j可以定位到pdf对应的位置。

以下代码可以在每次编译后，清理对应的文件

//设定清理文件的类型  
  "latex-workshop.latex.autoClean.run": "onBuilt",
  "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",  
    "*.nav",  
    "*.snm",  
  ], 

注意：.synctex.gz文件不要删除用于搜索定位的。

通过以上设置应该可以成功使用了~