MacTeX 配合 Visual Studio Code 进行 LaTeX 写作

MacTeX 配合 Visual Studio Code 进行 LaTeX 写作

TexLive 在 macOS 上的发行版是 MacTeX,若使用官方提供的安装包进行安装,还会一并附赠若干我们碰都不会碰的 GUI(图形用户界面)软件用来编辑 TeX 源文件和管理各类包。本文提供仅安装 MacTeX 核心组件且配置 VSCode 作为 LaTeX 文件编辑器的详细方案。

安装 MacTeX 和 Visual Studio Code

使用 Homebrew 安装上述软件。关于 Homebrew 的安装与使用可以参考我的另一篇文章安装和使用 Homebrew。

1brew install mactex-no-gui visual-studio-code

安装过程中会要求输入密码。

Homebrew 同时提供了 mactex 和 mactex-no-gui 两个 Cask,二者都使用从 CTAN 下载的原始安装包,但是后者在安装时会丢弃 GUI 组件。

更新 MacTeX 宏包

MacTeX 每年更新一次,下载的安装包会一同打包当时版本的宏包。一般来说,距离上次发布已经有很多宏包都经过了更新,所以我们需要更新已经过时的宏包。更新前先更换镜像源以加速下载,以上海交大源为例:

1sudo tlmgr option repository https://mirrors.sjtug.sjtu.edu.cn/ctan/systems/texlive/tlnet

更新 MacTeX 包:

1sudo tlmgr update --self --all

执行 sudo 命令会要求输入密码。

配置 Visual Studio Code

首先确保 LaTeX 的安装目录已经添加至 PATH。用 Homebrew 安装的 MacTeX 会自动添加至 PATH 中,如果没有,则需要手动添加。首次安装 MacTeX 后需要重启终端或者执行 eval "$(/usr/libexec/path_helper)" 来使路径生效。

1type xelatex

如果有显示如下输出,代表系统可以找到 LaTeX 编译器。

1xelatex is /Library/TeX/texbin/xelatex

我们使用 XeLaTeX 是因为它支持 Unicode 编码,可以编译中文文档。其他编译器大多只支持西文或不能访问系统的字体库,在一些情况下可能会无法正常编译。此外,就笔者个人观察,即使是全西文字符的文章,XeLaTeX 的编译结果也比 pdfLaTeX 更佳。

接下来,打开 VSCode,搜索并安装 LaTeX Workshop 插件。

最后,在 VSCode 配置文件 settings.json 的合适位置添加以下内容:

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778"latex-workshop.latex.tools": [ { "name": "xelatexmk", "command": "latexmk", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "-xelatex", "%DOCFILE%" ] }, { "name": "xelatex", "command": "xelatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOCFILE%" ] }, { "name": "bibtex", "command": "bibtex", "args": [ "%DOCFILE%" ] }],"latex-workshop.latex.recipes": [ { "name": "xelatexmk", "tools": [ "xelatexmk" ] }, { "name": "xelatex", "tools": [ "xelatex" ] }, { "name": "xelatex ➞ bibtex ➞ xelatex ×2", "tools": [ "xelatex", "bibtex", "xelatex", "xelatex" ] }],"latex-workshop.latex.clean.fileTypes": [ "*.aux", "*.bbl", "*.blg", "*.idx", "*.ind", "*.lof", "*.lot", "*.out", "*.toc", "*.acn", "*.acr", "*.alg", "*.glg", "*.glo", "*.gls", "*.fls", "*.log", "*.fdb_latexmk", "*.snm", "*.synctex*", "*.nav", "*.vrb", "*.xdv"],

各位读者可以根据自己的实际需求修改上述工具、配方和清理的文件类型。

如果设置了自动保存和自动编译,那么在源文件修改后可以近乎实时地看到编译结果,在享受 LaTeX 强大排版能力的同时还能做到其他文字排版工具的「所见即所得」。不过,如果你的机器性能不太够,或者文件内包含大尺寸图片或者大量 TikZ 画图会严重拖慢编译速度,此时建议打开草稿(draft)选项或关闭自动编译功能。

LaTeX Workshop 提供的便捷功能

打开一个 .tex 文件后,在 VSCode 左侧边栏会出现「TeX\TeXTE​X」的图标,点击可以展开 LaTeX Workshop 提供的便携功能。

命令区

上方是命令区,可以对文件执行编译、清理、定位、修改等操作。

结构区

中间是结构区,可以查看文件大纲和定位。

切片区

下方是切片区,里面提供了几乎所有数学符号,点击即可在光标处插入该符号。

相关推荐

篮球人口1.25亿!图解《中国篮球运动发展报告》
best365网页版登录官网

篮球人口1.25亿!图解《中国篮球运动发展报告》

📅 09-14 👁️ 9278
欻我是什么梗
365报价官网

欻我是什么梗

📅 01-24 👁️ 615
台式电脑主机线正确连接方法
365报价官网

台式电脑主机线正确连接方法

📅 02-12 👁️ 9503