Windows下使用VSCode + LaTeX Workshop + Tex Live搭建LaTex编译环境

短命女 2023-01-08 12:30 293阅读 0赞

# 0x00 前言 #

文章中的文字可能存在语法错误以及标点错误，请谅解；

如果在文章中发现代码错误或其它问题请告知，感谢！

Windows版本：Win10专业版

Tex Live版本：Tex Live 2020

VSCode版本：1.52.1

LaTeX workshop版本：v8.15.0

# 0x01 Tex Live的下载及安装 #

打开[Tex Live on DVD链接][Tex Live on DVD]，下载ios镜像，下载完成后双击该镜像进入镜像根目录，以右键管理员方式运行`install-ti-windows.bat`：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center]  
在弹出的`Tex Live Installer`窗口中，选择‘Specific mirror’即可选择下载源，可以选择`Asia->China`，然并选择清华的源（本例中选择默认源）：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 1]  
等待一段时间出现如下窗口：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 2]

选择该界面的`Advance`按钮进入到高级设置界面，在该界面中可以选择`Tex Live`安装路径、修改想要安装的宏包（本例中使用默认设置），并选择`安装`按钮进行安装：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 3]安装过程从30min到3h不等。安装完毕后，按住`win + R`打开CMD输入`tax --version`，有显示则表明安装成功：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 4]

# 0x02 VSCode下的LaTeX workshop配置 #

VSCode安装可以从其官网上下载，下载安装完成后打开VSCode，在插件市场安装`LaTex WorkShop`插件：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 5]

# 0x03 LaTex的编译测试 #

在本地新建一个文件夹并新建一个`.tex`结尾的文件，例如在桌面新建`latex_test`文件夹并新建一个`test.tex`文件，文件内容如下：

\documentclass[a4paper, 11pt]{ article}
    \title{ This is a Title}
    \author{ Qingchuan Wang}
    \date{ \today}
    \begin{ document}
        \maketitle
        This is the context of the article.
    \end{ document}

使用VSCode打开`latex_test`文件夹，选择`test.tex`文件，点击左侧Tex扩展插件，然后在`COMMANDS`中选择`Build LaTeX Project`编译 `test.tex`，最后选择`View LaTeX PDF`即可查看生成的PDF文档:  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 6]  
一般情况下我们常用的功能有`Build LaTex project`、`View LaTex PDF`、`View Log messages`，即`COMMANDS`前三个选项，该三个选项下有子选项，若不指定子选项则默认执行离选项最近的相关命令选项：

直接点击`Build LaTex project`则会执行`Recipe:latexmk`编译：  
![在这里插入图片描述][20210120164435830.png_pic_center]直接点击`View LaTex PDF`则会执行`View in VSCode tab`分屏加载编译好的pdf：  
![在这里插入图片描述][20210120164755514.png_pic_center]直接点击`View Log messages`则会执行`View LaTex compiler log`显示编译日志：  
![在这里插入图片描述][20210120164929344.png_pic_center]

# 0x04 LaTex的中文支持设置 #

注意，`Latex Workshop`插件目前支持编译英文文档，如需编译中文需要打开市场插件，选择`LaTex Workshop`的扩展设置：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 7]  
然后点击红框内图标，打开配置文件`settings.json`:  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 8]

在 `settings.json` 里修改如下内容：

{ 
        "latex-workshop.latex.recipes": [{ 
        "name": "xelatex",
        "tools": [
            "xelatex"
        ]
      }, { 
        "name": "latexmk",
        "tools": [
            "latexmk"
        ]
      },
      
      { 
        "name": "pdflatex -> bibtex -> pdflatex*2",
        "tools": [
            "pdflatex",
            "bibtex",
            "pdflatex",
            "pdflatex"
        ]
      }
      ],
      "latex-workshop.latex.tools": [{ 
      "name": "latexmk",
      "command": "latexmk",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "-pdf",
        "%DOC%"
      ]
      }, { 
      "name": "xelatex",
      "command": "xelatex",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "%DOC%"
      ]
      }, { 
      "name": "pdflatex",
      "command": "pdflatex",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "%DOC%"
      ]
      }, { 
      "name": "bibtex",
      "command": "bibtex",
      "args": [
        "%DOCFILE%"
      ]
      }],
      "latex-workshop.view.pdf.viewer": "tab",
      "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"
      ],
      "cmake.configureOnOpen": true,
      "explorer.confirmDelete": false,
      "git.ignoreWindowsGit27Warning": true,
      }

保存后即完成LaTex中文设置。

以上。

参考文档：  
1.[https://blog.csdn.net/qq\_42616792/article/details/104380454][https_blog.csdn.net_qq_42616792_article_details_104380454]  
2.[https://zhuanlan.zhihu.com/p/43133114][https_zhuanlan.zhihu.com_p_43133114]  
3.[https://blog.csdn.net/qq\_21567385/article/details/106943325][https_blog.csdn.net_qq_21567385_article_details_106943325]  
4.[https://www.bilibili.com/video/BV1Gt4y117VD?from=search&seid=9807797737525382162][https_www.bilibili.com_video_BV1Gt4y117VD_from_search_seid_9807797737525382162]

[Tex Live on DVD]: http://tug.org/texlive/acquire-dvd.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center]: /images/20221119/f808de0b8b3b44bd8ed5a7adf0878011.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221119/607b06d2ad2a48968d91767715389dd5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221119/987b52a50d78424bb232b8108368c46b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221119/088e49f3718147f18bfe667b6c014a1d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221119/d60ffc3202aa4988827a4d901cae7635.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221119/888c68f6f124419ea6b298ab5d5414d9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20221119/bd6d2b0a64024e539a4445467f71015b.png
[20210120164435830.png_pic_center]: /images/20221119/bb063dbed6674aa1959ff2cc23630793.png
[20210120164755514.png_pic_center]: /images/20221119/4626d0d587e5482b87c6c392e1e1e209.png
[20210120164929344.png_pic_center]: /images/20221119/003278226c9f4891ab6ab463410c080c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20221119/54724ef0450d408297231d06aef220aa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmdxaW5nY2h1YW45Mg_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20221119/5fed2f6184fd474f899a925fec303ff7.png
[https_blog.csdn.net_qq_42616792_article_details_104380454]: https://blog.csdn.net/qq_42616792/article/details/104380454
[https_zhuanlan.zhihu.com_p_43133114]: https://zhuanlan.zhihu.com/p/43133114
[https_blog.csdn.net_qq_21567385_article_details_106943325]: https://blog.csdn.net/qq_21567385/article/details/106943325
[https_www.bilibili.com_video_BV1Gt4y117VD_from_search_seid_9807797737525382162]: https://www.bilibili.com/video/BV1Gt4y117VD?from=search&seid=9807797737525382162