本文介绍在 macOS 上安装 MacTeX，并配置 VSCode + LaTeX Workshop，实现高效的 LaTeX 编译与写作环境。

一、安装 MacTeX

MacTeX 是 macOS 上最完整的 TeX 发行版，包含 LaTeX 编译工具链及相关字体与宏包。

1. 官方下载安装

访问官网： https://www.tug.org/mactex/

点击页面中的 MacTeX Download，进入下载页面后选择 MacTeX.pkg 安装包即可。

---

2. 使用 Homebrew 安装（推荐）

如果你使用 Homebrew，可以直接执行：

brew install --cask mactex

安装完成后，TeX 相关命令（如 latexmk、xelatex）会自动加入环境变量。

---

二、配置 VSCode

1. 安装插件

在 VSCode 插件市场中搜索并安装：LaTeX Workshop

这是目前最主流的 LaTeX 开发插件，支持自动编译、预览与错误提示。

---

2. 创建项目结构

建议为每个 LaTeX 工程单独建立文件夹，并使用项目级配置。

在项目根目录下创建：

.vscode/settings.json

---

3. 项目配置文件

将以下内容写入 settings.json：

{
    "editor.formatOnSave": false,
    "files.autoSave": "afterDelay",
    "files.autoSaveDelay": 1000,

    // ==================== 输出目录分离 ====================
    "latex-workshop.latex.outDir": "%DIR%/output", 
    "latex-workshop.latex.auxDir": "%DIR%/auxiliary",
    // ==================== 编译工具 ====================
    "latex-workshop.latex.tools": [
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-xelatex",
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-outdir=%OUTDIR%",
                "-auxdir=%AUXDIR%",
                "%DOC%"
            ]
        }
    ],

    // ==================== Recipe ====================
    "latex-workshop.latex.recipe.default": "latexmk (xelatex)",
    "latex-workshop.latex.recipes": [
        {
            "name": "latexmk (xelatex)",
            "tools": ["latexmk"]
        }
    ],

    // ==================== 关闭自动清理（关键修改） ====================
    "latex-workshop.latex.autoClean.run": "never",     // ← 改为 never，不再清理

    // ==================== LaTeX 文件设置 ====================
    "[latex]": {
        "editor.tabSize": 4
    }
}

---

三、使用示例

完成上述配置后，即可开始编写 LaTeX 文档。

在项目目录中新建一个 .tex 文件，例如 main.tex，写入如下内容：

\documentclass{beamer}

% 主题可自行替换
\usetheme{Madrid}

% 中文支持（MacTeX + xelatex）
\usepackage{fontspec}
\usepackage{xeCJK}

\setmainfont{Times New Roman}
\setCJKmainfont{PingFang SC}

\title{MacTeX + VSCode\\LaTeX 写作环境搭建}
\author{}
\date{}

\begin{document}

% 封面
\frame{\titlepage}

% 目录
\begin{frame}{目录}
\tableofcontents
\end{frame}

% ==================== 第一部分 ====================
\section{安装 MacTeX}

\begin{frame}{什么是 MacTeX}
\begin{itemize}
    \item macOS 上最完整的 TeX 发行版
    \item 包含：
    \begin{itemize}
        \item LaTeX 编译工具链
        \item 字体与宏包
    \end{itemize}
    \item 开箱即用，适合初学者与进阶用户
\end{itemize}
\end{frame}

\begin{frame}{安装方式一：官网下载安装}
\begin{itemize}
    \item 访问官网：
    \item \texttt{https://www.tug.org/mactex/}
    \item 点击：
    \begin{itemize}
        \item MacTeX Download
    \end{itemize}
    \item 下载并安装：
    \begin{itemize}
        \item \texttt{MacTeX.pkg}
    \end{itemize}
\end{itemize}
\end{frame}

\begin{frame}{安装方式二：Homebrew（推荐）}
\begin{itemize}
    \item 使用命令：
\end{itemize}

\begin{block}{}
\texttt{brew install --cask mactex}
\end{block}

\begin{itemize}
    \item 安装完成后自动配置环境变量
    \item 常用命令：
    \begin{itemize}
        \item \texttt{latexmk}
        \item \texttt{xelatex}
    \end{itemize}
\end{itemize}
\end{frame}

% ==================== 第二部分 ====================
\section{配置 VSCode}

\begin{frame}{安装 LaTeX 插件}
\begin{itemize}
    \item 在 VSCode 插件市场搜索：
    \item \textbf{LaTeX Workshop}
    \item 功能：
    \begin{itemize}
        \item 自动编译
        \item PDF 预览
        \item 错误提示
    \end{itemize}
\end{itemize}
\end{frame}

\begin{frame}{项目结构建议}
\begin{itemize}
    \item 每个项目单独目录
    \item 使用项目级配置
\end{itemize}

\begin{block}{目录结构}
\texttt{.vscode/settings.json}
\end{block}

\end{frame}

\begin{frame}[fragile]{核心配置（settings.json）}
\small
\begin{verbatim}
{
  "latex-workshop.latex.outDir": "%DIR%/output",
  "latex-workshop.latex.auxDir": "%DIR%/auxiliary",

  "latex-workshop.latex.tools": [
    {
      "name": "latexmk",
      "command": "latexmk",
      "args": [
        "-xelatex",
        "-outdir=%OUTDIR%",
        "-auxdir=%AUXDIR%",
        "%DOC%"
      ]
    }
  ],

  "latex-workshop.latex.autoClean.run": "never"
}
\end{verbatim}
\end{frame}

\begin{frame}{配置说明}
\begin{itemize}
    \item 输出目录：
    \begin{itemize}
        \item PDF $\rightarrow$ \texttt{output/}
    \end{itemize}
    \item 中间文件：
    \begin{itemize}
        \item \texttt{aux/log/synctex} $\rightarrow$ \texttt{auxiliary/}
    \end{itemize}
    \item 关闭自动清理：
    \begin{itemize}
        \item 便于调试与排错
    \end{itemize}
\end{itemize}
\end{frame}

% ==================== 第三部分 ====================
\section{使用示例}

\begin{frame}[fragile]{最小示例}
\begin{verbatim}
\documentclass{article}

\begin{document}

Beamer PPT 讲解：如何在 macOS 上配置 LaTeX 环境。

\end{document}
\end{verbatim}
\end{frame}

\begin{frame}{编译结果}
\begin{itemize}
    \item 保存后自动编译（或手动触发）
    \item 输出结果：
    \begin{itemize}
        \item PDF $\rightarrow$ output/
        \item 中间文件 $\rightarrow$ auxiliary/
    \end{itemize}
\end{itemize}
\end{frame}

% ==================== 第四部分 ====================
\section{总结}

\begin{frame}{总结}
\begin{itemize}
    \item MacTeX 提供完整 LaTeX 环境
    \item VSCode + LaTeX Workshop 提升效率
    \item 输出目录分离：
    \begin{itemize}
        \item 项目更整洁
        \item 更适合版本控制
    \end{itemize}
    \item 推荐使用 \texttt{latexmk + xelatex}
\end{itemize}
\end{frame}

\begin{frame}
\centering
\Huge 谢谢！
\end{frame}

\end{document}

保存文件后，VSCode 会根据配置自动触发编译（或使用快捷键手动编译）。编译成功后：

• 生成的PDF 文件位于 output/ 目录
• 所有中间文件（如 .aux、.log、.synctex.gz）统一存放在 auxiliary/ 目录

这样可以保证项目根目录整洁，结构清晰，便于管理与版本控制。

---

四、总结

通过以上步骤，我们在 macOS 上搭建了一套基于 MacTeX 与 VSCode 的 LaTeX 写作环境，实现了完整的编译工具链与高效编辑体验，同时通过项目级配置将 PDF 输出与中间文件分离，保持目录结构清晰，避免频繁清理带来的性能问题。这种方式兼顾易用性与可维护性，适合论文、报告以及需要版本控制的中大型 LaTeX 项目。