Mac LaTeX VSCode 配置教程（从零开始实现 Mac 完美支持 LaTeX 中文排版）

在 macOS 系统上，使用 VSCode 编写 LaTeX 已经成为许多学术开发者的首选。本文将手把手教你如何完成 Mac LaTeX 安装，并解决最核心的 VSCode LaTeX 中文 显示与编译问题。

本文涉及的核心关键词：Mac LaTeX 安装、VSCode LaTeX 中文、MacTeX 配置、LaTeX Workshop 设置。

第一步：安装 MacTeX 发行版

要在 Mac 上运行 LaTeX，首先需要一个完整的后端环境。推荐下载安装 MacTeX，它是 macOS 上最稳定、最全的发行版。

打开 VSCode，在插件市场（Extensions）中搜索并安装 LaTeX Workshop。该插件是 VSCode 编写 LaTeX 的灵魂，提供了实时预览、语法高亮和编译自动化功能。

为了让文档支持中文显示，我们需要将编译引擎改为 XeLaTeX。在 VSCode 设置中打开 settings.json，添加或修改以下配置：

"latex-workshop.latex.recipes": [{  "name": "xe->bib->xe*2",  "tools": ["xelatex", "bibtex", "xelatex", "xelatex"]}]

通过这一步 MacTeX 配置，你的环境就具备了处理中文字符的能力。

新建一个以 .tex 结尾的文件，输入以下代码进行测试：

\documentclass{ctexart}\begin{document}你好，VSCode LaTeX！这是中文测试。\end{document}

点击 VSCode 左侧 LaTeX 图标，选择编译。如果配置正确，你会看到生成的 PDF 成功显示中文。这是 LaTeX Workshop 设置 中最基础也最重要的一环。

通过以上四个步骤，你已经成功掌握了在 Mac 上使用 VSCode 编写 LaTeX 的全过程。只要确保使用 ctexart 宏包并配置好 XeLaTeX 引擎，中文排版将不再是难题。