【Mac+VSCode+Latex】在 Mac 上使用 VSCode 编写 LaTeX

原创

已于 2025-09-22 01:45:14 修改 · 3.5k 阅读

标签

#macos #vscode #Latex #论文写作 #AI顶会

于 2025-09-22 01:36:07 首次发布

核心思路

在 VSCode 中配置 LaTeX 环境需要三个部分：

LaTeX 发行版 (TeX Distribution)：核心编译器，如 pdflatex, xelatex, lualatex。
VSCode 扩展 (Extension)：提供语法高亮、代码片段、编译命令、预览等功能。
配置 VSCode：设置扩展以满足你的特定需求（如编译工具链、正反向搜索等）。

第一步：安装 LaTeX 发行版 (MacTeX)

你需要先安装一个 LaTeX 编译环境。在 macOS 上，最主流和推荐的选择是 MacTeX。

访问官网：
打开 MacTeX 官方网站。
下载安装包：
点击下载 MacTeX.pkg（完整版，约 4.5 GB）。它包含了所有常用的宏包和工具，适合大多数用户。如果你的网络或磁盘空间有限，也可以选择较小的 BasicTeX，但之后可能需要手动安装缺少的宏包。
安装：
下载完成后，双击 .pkg 文件，按照图形界面的指引一步步完成安装即可。安装过程非常简单，和安装其他 macOS 软件没有区别。
验证安装 (可选)：
打开终端 (Terminal)，输入以下命令：
```
latex --version
```
如果安装成功，它会返回 LaTeX 的版本信息。同样可以测试 xelatex --version 和 pdflatex --version。

第二步：安装 VSCode 和 LaTeX 扩展

安装 VSCode：
如果你还没有安装，请从 VSCode 官网下载并安装。
安装 LaTeX Workshop 扩展：
这是 VSCode 上最强大、最受欢迎的 LaTeX 扩展。
- 打开 VSCode。
- 点击左侧活动栏的「扩展」图标 (或按 Cmd+Shift+X)。
- 在搜索框中输入 latex workshop。
- 找到由 James Yu 开发的 LaTeX Workshop，点击「安装」。

第三步：基本配置与使用

安装完成后，你就可以开始使用了。让我们创建一个简单的测试文件。

创建一个新的 .tex 文件：
- 新建一个文件夹作为你的项目目录。
- 在 VSCode 中打开这个文件夹 (File > Open Folder...)。
- 在该文件夹中创建一个新文件，命名为 test.tex。

输入基础内容：
将以下代码复制到 test.tex 中：

\documentclass{article}
\usepackage[utf8]{inputenc}

\title{My First LaTeX Document in VSCode}
\author{Your Name}
\date{\today}

\begin{document}

\maketitle

\section{Introduction}
Hello, World! This is a simple LaTeX document compiled using VSCode and LaTeX Workshop.

\end{document}

基本配置

为了让体验更好，你可能需要根据习惯进行一些自定义配置。特别是如果你需要处理中文文档。

打开设置：
在 VSCode 中，按 Cmd+, 打开设置 (Settings)。
搜索 LaTeX 配置：
在顶部的搜索框中输入 latex，所有与 LaTeX Workshop 相关的设置都会出现。
修改编译工具链 (Recipe)（非常重要！）：
LaTeX Workshop 使用「Recipes」来决定用什么命令（如 pdflatex, xelatex