MacOS上VSCode配置LaTeX中文显示（从安装到使用的完整教程）

本教程将详细指导您在MacOS系统上使用VSCode编辑LaTeX文档，并解决中文显示问题。无论您是初学者还是有一定经验的用户，都能轻松跟随步骤完成配置。我们将涵盖从软件安装到中文显示设置的全过程，确保您能顺利在MacOS上使用LaTeX进行中文文档编写。

1. 安装MacTeX：LaTeX发行版

首先，安装MacTeX，这是一个专为MacOS设计的LaTeX发行版，包含了编译LaTeX所需的所有工具。访问MacTeX官网（https://tug.org/mactex/）下载安装包，然后双击运行并按照向导完成安装。安装过程可能需要一些时间，请确保网络连接稳定。

2. 安装VSCode：代码编辑器

VSCode（Visual Studio Code）是一款免费、开源的代码编辑器，支持多种编程语言和扩展。从VSCode官网（https://code.visualstudio.com/）下载Mac版本，安装后打开VSCode。VSCode的轻量级和可扩展性使其成为LaTeX编辑的理想选择。

3. 安装LaTeX插件：LaTeX Workshop

在VSCode中，点击左侧活动栏的扩展图标（或按Shift+Cmd+X），搜索“LaTeX Workshop”，找到由James Yu开发的插件并安装。这个插件提供了LaTeX编译、预览、语法高亮等功能，极大简化了LaTeX工作流程。

MacOS上VSCode配置LaTeX中文显示（从安装到使用的完整教程） MacOS LaTeX VSCode 中文显示第1张

4. 配置中文显示：使用xeLaTeX和ctex

为了在LaTeX中正确显示中文，需要配置编译引擎为xeLaTeX，并使用ctex包。在VSCode中，按Cmd+, 打开设置，搜索“latex”，找到“LaTeX › Tools: Chained commands”或类似选项，添加编译命令为“xelatex”。同时，在LaTeX文档中，使用\documentclass{ctexart}来启用中文支持。这确保了中文显示无误，并兼容MacOS系统。

5. 创建和编译LaTeX文档

在VSCode中新建文件（Ctrl+N），保存为“example.tex”。输入以下内容：

\documentclass{ctexart}�egin{document}你好，世界！这是一个LaTeX中文文档示例，在MacOS上使用VSCode编辑。\end{document}

保存后，按Ctrl+Alt+B编译文档。VSCode会调用xeLaTeX生成PDF，并在侧边栏预览。如果配置正确，您将看到中文正常显示。关键词如MacOS、LaTeX、VSCode和中文显示在本教程中反复强调，以帮助搜索引擎优化和用户理解。

6. 常见问题与解决

如果中文显示为乱码，请检查：1) 是否安装了完整版MacTeX；2) VSCode中LaTeX插件设置是否正确；3) 文档是否使用ctexart类。此外，确保系统字体包含中文字体，如Songti SC。通过本教程，您应该能在MacOS上顺利使用VSCode进行LaTeX中文文档编写，享受高效排版体验。