利用VSCode编写LaTeX文件

阅读数：94次 2022-09-22

字数统计: 837字 | 阅读时长: 3分

前言

在MacOS上安装LaTeX环境，并利用VSCode编写LaTeX文档。

在MacOS上安装LaTeX环境

有两种环境可供安装，完整的MacTeX和BasicTeX。

完整的 MacTeX-2022 安装包包含四个部分：

TeX Live 2022：包含超过 4 GB 材料的完整发行版。
GUI 应用程序：前端、实用程序和少量启动文档。
Ghostscript 9.55
Ghostscript 库 libgs，仅由 TeX Live 中的一个程序 dvisvgm 使用。

BasicTeX 仅包含完整发行版的 TeX Live 片段，即编写 TeX 文档所需的所有标准工具，包括 TeX、LaTeX、pdfTeX、MetaFont、dvips、MetaPost 和 XeTeX。且包含 AMSTeX、拉丁现代字体、用于从 TeX Live 添加和更新包的 TeX Live 管理器以及 SyncTeX。

BasicTeX 不包含 GUI 程序和 Ghostscript。要在 Mac 上使用 TeX，安装 BasicTeX 和前端就足够了。BasicTeX不会覆盖整个发行版，它安装在/usr/local/texlive/2022basic中。

这里选择安装BasicTeX，可以在这里下载，也可以直接使用brew install basictex安装。

下载完了以后tlmgr --help有反应证明安装成功，tlmgr是TeX Live中的包和配置管理器，完全独立于操作系统可能提供的任何包管理器。

TeX, LaTeX, XeLaTeX

LaTeX 是 TeX 中的一种格式(format) ，是建立在 TeX 基础上的宏语言，每一个 LaTeX 命令实际上最后都会被转换解释成几个甚至上百个TeX 命令。

XeLaTeX是使用LaTeX的排版引擎，命令下直接使用xelatex ***.tex就会产生对应的PDF文件。

.cls, .sty

.cls和.sty文件都是增加 LaTeX 功能的补足文件。它们在我们排版文章时对应的使用\documentclass{}和\usepackage{}加载，在包内部则对应的使用\LoadClass, \LoadClassWithOptions和\RequirePackage, \RequirePackageWithOptions加载。我们通常将.cls文件称之为类（classes）文件，将.sty文件称之为风格（style）文件或者包（package）。

虽然它们都可以包含任意的 TeX 和 LaTeX 代码，但它们的使用方式不同。我们必须通过\documentclass{}加载一个类文件，并且在一个 LaTeX 文件中只能出现一次，通常也是第一个出现的命令。而包是一个可选项，它可以根据我们的需求加载任意多个（在开始文档之前）。

.sty文件缺失问题

报错：LaTeX Error: File `xxx.sty‘ not found，则需要安装对应包。

自动安装：
sudo tlmgr install xxx

手动安装：
1、放置文件到/usr/local/texlive/2022basic/texmf-dist/tex/latex下
2、sudo texhash
3、sudo mktexlsr

tlmgr命令

tlmgr install <packagename>     安装宏包
tlmgr remove <packagename>      移除
tlmgr update --list         查看所有更新的宏包指令
tlmgr update --self --all   更新所有需要更新的宏包

配置VSCode作为前端

1. 环境变量确认

使用brew下载BasicLaTeX的话，先把TeXLive添加到环境变量，在.bash_profile下新增：export PATH=$PATH:/usr/local/texlive/2022basic/bin/universal-darwin

查看是否添加成功：echo $PATH

2. 安装插件

1、James-Yu.latex-workshop

3. 安装Latexmk

BasicTeX不含Latexmk，但插件James-Yu.latex-workshop需要该Perl脚本支持。通过sudo tlmgr install latexmk安装。

注意：如需使用中文需要额外配置。

参考文献

[1]https://blog.csdn.net/tsingke/article/details/105960941
[2]https://blog.csdn.net/joey_ro/article/details/123441178
[3]https://zhuanlan.zhihu.com/p/289417922
[4]https://blog.csdn.net/joey_ro/article/details/123387085
[5]https://www.cnblogs.com/ouyangsong/p/9348175.html
[6]https://mg.readthedocs.io/latexmk.html
[7]https://www.jianshu.com/p/4aee83e66ab8