1. 为什么选择VSCode+LaTeX组合

如果你经常需要撰写学术论文、技术文档或者数学公式密集的文稿，LaTeX绝对是比Word更专业的选择。但在Mac上直接使用传统的TeX编辑器，界面往往显得老旧，功能也不够现代化。这就是为什么我要推荐VSCode+LaTeX这对黄金搭档。

我最早接触LaTeX是在读研期间，当时用的是一个叫TeXShop的编辑器。虽然功能还行，但每次编译都要手动点击，错误提示也不够直观。后来尝试了VSCode配合LaTeX Workshop插件，工作效率直接翻倍。最让我惊喜的是实时预览功能，写公式时能立即看到效果，再也不用反复编译了。

VSCode的优势在于：

• 轻量快速：启动速度远超传统IDE
• 插件丰富：LaTeX Workshop提供了编译、预览、错误检查等全套工具
• 高度可定制：可以根据个人习惯调整快捷键和工作流
• 多语言支持：写论文时经常需要中英文混排，VSCode处理得非常好

2. 基础环境搭建

2.1 安装MacTeX

LaTeX本质上是一个排版系统，需要先安装引擎和基础包。在Mac上推荐使用MacTeX这个发行版，它包含了完整的LaTeX环境。虽然BasicTeX更轻量，但缺少很多常用包，后期补装反而更麻烦。

安装方法很简单：

brew install --cask mactex

这个命令会自动下载并安装最新版的MacTeX。安装完成后，需要把TeX的二进制路径加到环境变量里：

export PATH=/usr/local/texlive/2023/bin/universal-darwin:$PATH

建议把这行加到你的shell配置文件（.zshrc或.bashrc）里，这样每次打开终端都能直接使用LaTeX命令。

2.2 安装VSCode

VSCode的安装就更简单了：

1. 官网下载Mac版安装包
2. 拖拽到Applications文件夹
3. 第一次启动时，建议安装"Code"命令到PATH，这样以后在终端输入code .就能用VSCode打开当前目录

安装完成后，我习惯先做这些基础设置：

• 调整字体大小（建议14-16px）
• 开启自动保存
• 安装中文语言包（如果需要）

3. LaTeX Workshop插件配置

3.1 插件安装与基础设置

在VSCode的扩展商店搜索"LaTeX Workshop"并安装。这个插件提供了LaTeX写作所需的所有功能：编译、预览、错误检查、代码补全等。

安装完成后，按Cmd+,打开设置，搜索"latex"，你会看到很多配置项。我建议直接编辑settings.json文件：

{
    "latex-workshop.latex.autoBuild.run": "onFileChange",
    "latex-workshop.view.pdf.viewer": "tab",
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": false
}

这几个设置的意思是：

• 文件修改时自动编译
• PDF在VSCode内置标签页中预览
• 不弹出烦人的错误/警告弹窗（错误会在问题面板显示）

3.2 配置编译链

LaTeX文档通常需要多次编译才能生成完整的PDF（特别是包含参考文献时）。LaTeX Workshop允许我们自定义编译流程。这是我的推荐配置：

"latex-workshop.latex.recipes": [
    {
        "name": "xelatex",
        "tools": ["xelatex"]
    },
    {
        "name": "latexmk",
        "tools": ["latexmk"]
    },
    {
        "name": "pdflatex -> bibtex -> pdflatex*2",
        "tools": ["pdflatex", "bibtex", "pdflatex", "pdflatex"]
    }
],
"latex-workshop.latex.tools": [
    {
        "name": "latexmk",
        "command": "latexmk",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-pdf",
            "%DOC%"
        ]
    },
    {
        "name": "xelatex",
        "command": "xelatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    }
]

这个配置提供了三种编译方案：

1. 简单的xelatex单次编译（适合快速预览）
2. latexmk自动处理编译流程（我的首选）
3. 完整的pdflatex+bibtex流程（处理参考文献必备）

4. 中文支持与实用技巧

4.1 处理中文文档

要让LaTeX支持中文，最简单的方法是使用ctex文档类：

\documentclass[UTF8]{ctexart}
\begin{document}
你好，LaTeX！
\end{document}

ctex会自动配置中文字体和排版规则。如果你需要更精细的控制，可以手动引入xeCJK包：

\usepackage{xeCJK}
\setCJKmainfont{STSong}  % 设置中文字体

4.2 同步滚动与反向搜索

LaTeX Workshop支持PDF和源代码的同步滚动：

1. 编译时加上-synctex=1参数（前面的配置已经包含）
2. 在PDF中Cmd+点击可以跳转到对应源码
3. 在源码中Cmd+Alt+J可以跳转到PDF对应位置

这个功能在调试长文档时特别有用，能快速定位问题所在。

4.3 代码片段(Snippets)

VSCode的代码片段功能可以极大提升LaTeX写作效率。比如创建一个快速插入数学环境的片段：

{
    "Insert Math Environment": {
        "prefix": "math",
        "body": [
            "\\begin{$1}",
            "\t$0",
            "\\end{$1}"
        ],
        "description": "Insert math environment"
    }
}

这样输入math后按Tab，就能快速插入数学环境框架，光标会自动停在合适的位置。

5. 高级定制与优化

5.1 使用tlmgr管理宏包

MacTeX自带的tlmgr（TeX Live Manager）是管理LaTeX宏包的神器。我习惯先换国内镜像加速下载：

sudo tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet

然后更新tlmgr自身：

sudo tlmgr update --self

安装新包也很简单，比如要安装minted代码高亮包：

sudo tlmgr install minted

5.2 自定义构建任务

对于复杂项目，可以创建.vscode/tasks.json来自定义构建流程。比如我要先清理临时文件再编译：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Clean and Build",
            "type": "shell",
            "command": "latexmk -c && latexmk -pdf",
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

这样按Cmd+Shift+B就能执行这个任务。

5.3 多文件项目管理

大型LaTeX项目通常拆分成多个.tex文件。主文档通过\input或\include引入子文件。LaTeX Workshop默认会跟踪这些依赖关系，但有时需要手动配置：

"latex-workshop.latex.rootDir": "%DIR%",
"latex-workshop.latex.mainFile": "%DOC%.tex"

这样插件就能正确识别项目入口文件。