科研学术的写作环境搭配（LaTeX+VSCode+Sumatra PDF/Skim）Win/Mac通用_latex 必须用sumatrapdf吗

  以前写论文的时候经常使用的是Word，往往写完论文后排版需要花上个1-2天。虽然通过了计算机二级考试，但是深深觉得Word的排版非常辛苦，一次偶然的机会在B站上了解到了LaTeX，一开始感觉用代码写文章非常神奇，有点像Markdown，但LaTeX的语法和表达形式非常丰富，而且实际上写论文用它无非是套用个模板，我们只要把文字填充到代码里面就好了，能导出跟Word一样美观的文章，个人感觉非常实用，极大提高了生产效率，因此决定好好学习LaTeX，并在VSCode中搭建起自己的写作环境。

网页版的LaTeX

  其实说到LaTex，如果你想在线体验或者觉得搭建环境很麻烦，可以直接用网页版的LaTeX，也就是OverLeaf，网址是：https://www.overleaf.com/，这个网站上有很多期刊的LaTex格式，而且是在线编译器，用起来很方便。

Sumatra PDF/Skim PDF阅读器的安装

  这是两个都是非常轻量的PDF阅读器，当然已经有其他合适的PDF阅读器也是可以的。
  Sumatra PDF是在Win系统上使用的，Skim是在Mac系统上使用的，下载和安装非常迅速，而且也没有什么需要注意的，最多就是安装路径要选择一下，比如我一般安装路径不会放在C盘。
  Sumatra PDF下载地址：https://www.sumatrapdfreader.org/download-free-pdf-viewer
  Skim下载地址：https://skim.en.softonic.com/mac

LaTeX的安装

  可以去清华大学开源软件镜像站去下载texlive，它是一个LaTeX安装编译包。
  下载地址：https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/

  有4.3G还是比较大的，下载好后文件是这样的：

  双击点击进入后，可以看到：

  右键以管理员身份运行该程序：

  一个命令行小黑框后会出现GUI界面，这里的Installation root就是你的安装路径，可以修改到其他存储盘，这里的安装TeXworks前端可以不勾选，因为我们之后的操作都会在VSCode中编译，所以可以取消掉勾选，然后选择Advanced。

  在安装程序中打开左下角的Customize，这里是让你选择语言的，只要勾选Chinese和UK/US就可以了，其他语言可以不选择，这样能节约很多存储空间。

  然后点击安装，就会进入漫长的安装过程，全程大概需要半个小时，只要挂在那边就行了。

  安装好后就会提示你，“欢迎进入 TeX Live 的世界！”

  到这一步，我们的LaTeX就安装完成了，接下来是VSCode的环境配置了，不过要记一下自己的安装路径，我这里是安装到E盘的。

VSCode的插件配置

  在VSCode中安装LaTeX的相关拓展插件，其中最重要的就是LaTex Workshop。

  在VSCode中使用快捷键Ctrl+Shift+P，出现一个搜索框，输入JSON，选择Preferences:Open User Settings(JSON)这个，从而就能打开settings.json，进行环境配置了。

  正常里面的内容是这样的：

  我们需要在这里面写一些配置，这里最重要的就是要把Sumatra PDF跟LaTeX的本地路径写对，而不能简单的复制粘贴，除非你跟我的路径一模一样，如果是MAC系统应该可以不用管。
要注意的三个点：

1. 修改路径的时候，如果复制过来路径是\记得改成/；
2. 如果找不到自己的安装路径了，可以在电脑左下角的搜索框里面输入软件的名称，然后右键选择打开文件位置，如果看见的是快捷方式，那么继续对快捷方式右键选择打开文件所在位置，最后就可以找到exe程序所在的位置了；
3. 原本的JSON文件里面有个"git.enableSmartCommit": true，要在后面加一个逗号“,”，不然会出现语法错误。

  完整的JSON内容：

{
    "workbench.colorTheme": "Default Dark+",
    "git.enableSmartCommit": true,
    // ===================================LaTeX的相关配置，切记选择对自己的软件路径===================================
    // bibtex 格式
    "latex-workshop.bibtex-format.tab": "tab",
    
    // 个人比较喜欢保存后就会自动编译，所以选择了onSave
    "latex-workshop.latex.autoBuild.run": "onSave",
    "latex-workshop.latex.autoBuild.cleanAndRetry.enabled": false,

    // 设置 latex-workshop 的 PDF　预览程序，external　指的是外部程序
    "latex-workshop.view.pdf.viewer": "external",
    "latex-workshop.view.pdf.ref.viewer": "external",
    "latex-workshop.view.pdf.external.viewer.command": "C:/Users/colof/AppData/Local/SumatraPDF/SumatraPDF.exe", // 注意修改SumatraPDF路径 如果复制过来路径是\记得改成/
    "latex-workshop.view.pdf.external.viewer.args": [
        "-forward-search",
        "%TEX%",
        "%LINE%",
        "-reuse-instance",
        "-inverse-search",
        "code.cmd -r -g \"%f\":%l",
        "%PDF%"
    ],

    // 配置正向、反向搜索：.tex -> .pdf
    "latex-workshop.view.pdf.external.synctex.command": "C:/Users/colof/AppData/Local/SumatraPDF/SumatraPDF.exe", // 注意修改SumatraPDF路径
    "latex-workshop.view.pdf.external.synctex.args": [
        // 正向搜索
        "-forward-search",
        "%TEX%",
        "%LINE%",
        "-reuse-instance",
        // 反向搜索
        "-inverse-search",
        "\"E:/Microsoft VS Code/Code.exe\" \"E:/Microsoft VS Code/resources/app/out/cli.js\" -gr %f:%l",//注意修改VSCode路径
        "%PDF%"
    ],


    // 清空中间文件，最终只会保存tex和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",
        "*.gz"
    ],
    "latex-workshop.latex.autoClean.run": "onBuilt",
    // 使用上次的recipe编译组合
    "latex-workshop.latex.recipe.default": "lastUsed",
    // 用于反向同步的内部查看器的键绑定。ctrl/cmd +点击(默认)或双击
    "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",
    "window.zoomLevel": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

测试

  去OverLeaf网站上找个模板测试一下：

  可以看到，我们已经能够成功编译并且浏览了，到这里，LaTeX+VSCode+Sumatra PDF/Skim的科研学术写作环境就搭配完成了，后面就是一些插件的按照，能够提高写作的效率/愉悦感。
  说明一下，正向和反向搜索就是你点击源代码或者PDF会跳转到对应位置，如果设置"latex-workshop.latex.autoClean.run": "onBuilt"是不能成功实现的，要改成onFailed才行。

好用的插件

Ultra Math Preview

  一款可以实时查看LaTeX代码里面的公式的插件，比较好用。

遇到的问题

• Recipe terminated with fatal error: spawn xelatex enoent.

  这个是因为环境变量中没有加入LaTeX的路径（搜索“查看高级系统设置”）。注意，这里是用户和系统的Path都必须要都引入，弄好后必须要重启电脑，才能在VSCode中访问到LaTeX的路径，可以在终端中输入tex -v来测试一下是不是真的弄好了。


  弄好后记得确定保存，然后重启电脑就可以了。