macOS Catalina 10.15.4 安装 MiKTeX 实录

这篇文章记录了在 macOS Catalina 10.15.4 上安装 MiKTeX 的过程。因为 macOS 上安装 MiKTeX 很难成功投入使用，所以特此记录一篇，供大家参考。

首先需要声明的是，你的 macOS 不一定需要是（现在刚出的最新的）Catalina 10.15.4，任何可以安装 MiKTeX 的 macOS 系统都可以安装 MiKTeX，只是我的系统版本为 10.15.4 而已。

首先在 MiKTeX 官网上下载磁盘映像文件，下载完成后直接将 MiKTeX 拖进“应用程序”文件夹里即可。

然后是比较关键的一步。打开 MiKTeX 后，MiKTeX 会询问你正式安装的方式。选择只为当前用户安装（Private Use），之后等待一会儿（应该需要联网），直到安装完成提示你需要重启 MiKTeX。

接下来可以去安装你需要的宏包。复制一份你以前写的 LaTeX 文件到桌面，然后从 MiKTeX 控制台中进入 TeXworks，在 TeXworks 中打开你的文件，用 XeLaTeX 编译。

图：打开 TeXworks

期间很有可能会提示你安装宏包，取消勾选“始终提醒我”，然后点击安装。如果点错点成不安装（Cancel）了，需要到 MiKTeX 控制台中重新设置，这里就不提了。等待一会儿后，可以看见编译结果。

图：第一次编译

可见，可以编译成功，但是无法显示中文（这个文档中已经包含了 ctex）。下面来解决中文显示问题。

参见这篇博客。

\documentclass[UTF8, a4paper, fontset = macnew]{article} % fontset = macnew

这里给一下复制字体的方法。在字体册的文件栏中选择“导出字体”，找到导出的“Kaiti.tcc”复制到上面博客说的文件夹中即可。复制后，再次编译，成功显示中文：

图：稍许修改源代码并复制 Kaiti.tcc 到指定位置后的编译

下面我们要配置在 Visual Studio Code 里面的 LaTeX 环境。打开刚刚我们用来测试的文件，在 LaTeX Workshop 里面点击编译后，发现如下问题。（这里还没有对扩展进行任何配置，使用的是默认设置，直接点的编译键）

右下角显示：Recipe terminated with fatal error: spawn latexmk ENOENT.

由于这里我们只使用 XeLaTeX 编译，因此我们先设置成 XeLaTeX 再说。打开设置，在文本型设置中加入以下语句。

    "latex-workshop.latex.tools": [
        {
            "name": "XeLaTeX",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOC%"
            ],
            "env": {}
        }
    ],
    "latex-workshop.latex.recipes": [
        {
            "name": "XeLaTeX",
            "tools": [
                "XeLaTeX"
            ]
        }
    ],

然后重启 VS Code。再次编译，仍然出错，不过错误信息变成了 Recipe terminated with fatal error: spawn xelatex ENOENT.。

这个错误应该是路径问题，在终端中直接输入 xelatex 被告知命令不存在，于是考虑修复路径。

参见这篇文档。打开终端，在终端中输入：

sudo launchctl config user path "$HOME/bin:$PATH"

然后照提示重启计算机，再次打开 VS Code 编译，即可完成编译。之后如果需要配置其他工具，可以仿照上面的 JSON 片段进行配置。