LaTeX 入门 · 前置篇 搭建 LaTeX 编写环境

2.1 下载#

官方下载页：https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/（清华镜像，国内速度快）

下载其中的 ISO 镜像文件（如 texlive.iso），大小约 4–5 GB。

2.2 安装#

在 Windows 资源管理器中，右键挂载下载好的 ISO 镜像，进入挂载的虚拟光驱，找到并双击运行 install-tl-windows.bat：

安装界面如上图。几个要点：

• 安装路径：默认装在 C:\texlive\2026，可点「修改」改到其他盘（路径尽量不要含中文和空格）。
• 完整安装 vs 最小安装：默认是完整安装（scheme-full），占用约 7 GB，省心；磁盘紧张可选最小安装，但后续可能要手动补装宏包。
• 确认后点「安装」，等待安装完成。完整安装耗时较长（30 分钟到 1 小时，取决于磁盘速度）。

2.3 验证安装#

安装完成后重启 VS Code（让环境变量生效），然后在 VS Code 终端（Ctrl + ~）执行：

1
pdflatex --version
2
xelatex --version
3
latexmk --version

三个命令都能正常输出版本信息，说明 TeX Live 安装成功，编译器已加入系统 PATH。

如果终端报 无法将"xelatex"识别为 cmdlet...，说明 PATH 没配好。检查系统环境变量里是否包含 C:\texlive\2026\bin\windows（版本号和路径按实际安装情况）。通常重启系统可解决；若仍不行，需手动将该路径添加到 PATH。

3.1 VS Code#

VS Code 从官网下载安装：https://code.visualstudio.com/，过程与普通软件相同。

3.2 LaTeX Workshop 插件#

打开 VS Code，按 Ctrl + Shift + X 打开扩展面板，搜索 LaTeX Workshop：

认准发布者为 James Yu 的那个，点「安装」。

装完 LaTeX Workshop 后，不要再装其他 LaTeX 编译或预览插件（如 LaTeX Tools、TeXLab 等），避免功能冲突。LaTeX Workshop 一个插件就覆盖了编译、预览、正反向跳转、代码补全的全部需求。

4.1 编译工具链：latexmk#

LaTeX Workshop 默认用 latexmk 作为编译工具链。latexmk 是一个智能编译器包装器，它会自动判断需要编译几次、是否要跑 BibTeX，一个命令搞定目录、交叉引用、参考文献的所有依赖。

插件内置的默认 tool 定义如下（源自扩展 package.json，无需手动配置）：

1
{
2
  "name": "latexmk",
3
  "command": "latexmk",
4
  "args": [
5
    "-synctex=1",
6
    "-interaction=nonstopmode",
7
    "-file-line-error",
8
    "-pdf",
9
    "-outdir=%OUTDIR%",
10
    "-auxdir=%AUXDIR%",
11
    "%DOC%"
12
  ]
13
}

各参数含义：

• -pdf：用 pdflatex 编译，输出 PDF；
• -synctex=1：生成同步定位信息，支持 PDF 和源代码之间的正反向跳转；
• -interaction=nonstopmode：遇到错误不暂停，继续编译；
• -outdir / -auxdir：指定输出目录和辅助文件目录；
• %DOC%：占位符，编译时替换为当前 .tex 文件的完整路径（不含扩展名）。

4.2 中文文档：用 xelatex recipe#

含中文的文档需要 xelatex 编译。LaTeX Workshop 已经内置了 xelatex 的 recipe，不需要改 settings.json。

编译时在 VS Code 左侧活动栏点 TeX 图标，在「Build LaTeX project」下展开 recipe 列表，选 latexmk (xelatex) 即可。它对应的内置 tool 是：

1
{
2
  "name": "xelatexmk",
3
  "command": "latexmk",
4
  "args": [
5
    "-synctex=1",
6
    "-interaction=nonstopmode",
7
    "-file-line-error",
8
    "-xelatex",
9
    "-outdir=%OUTDIR%",
10
    "-auxdir=%AUXDIR%",
11
    "%DOC%"
12
  ]
13
}

和默认 latexmk 的唯一区别是 -pdf 换成了 -xelatex。

如果希望含中文的文档默认就用 xelatex 编译（不用每次手动切 recipe），可以把 xelatexmk 这个 recipe 调到 latex-workshop.latex.recipes 列表的第一位——LaTeX Workshop 总是使用列表第一个 recipe 作为默认编译方式。

4.3 常用配置项#

4.4 PDF 正反向跳转#

这是 LaTeX Workshop 最实用的功能之一：

• 正向跳转（源码 → PDF）：在 .tex 里右键 →「SyncTeX from cursor」，或快捷键 Ctrl + Alt + J；
• 反向跳转（PDF → 源码）：在 PDF 预览里 Ctrl + 左键 点击某个位置，光标会跳到对应的源代码。

前提是编译时带了 -synctex=1（默认已带）。

5.1 新建项目#

新建一个文件夹（如 latex-test），用 VS Code 打开，在其中创建 hello.tex：

1
\documentclass{ctexart}
2

3
\title{环境验证}
4
\author{测试}
5
\date{\today}
6

7
\begin{document}
8
\maketitle
9

10
你好，\LaTeX{}。这是一份用于验证编译环境的测试文档。
11

12
\section{公式测试}
13
勾股定理：$a^2 + b^2 = c^2$。
14

15
\end{document}

5.2 编译并预览#

编译有两种触发方式：

1. 自动编译（默认开启）：插件的 latex-workshop.latex.autoBuild.run 默认值是 onFileChange，意思是只要检测到依赖文件变化（包括保存 .tex）就会自动编译。所以正常情况下保存文件就会触发编译，无需额外配置。
2. 手动编译：点击左侧活动栏的 TeX 图标 →「Build LaTeX project」，或快捷键 Ctrl + Alt + B。

编译完成后点「View LaTeX PDF」，或快捷键 Ctrl + Alt + V，会在侧边打开 PDF 预览：

源代码和 PDF 并排显示，改一处保存，右侧 PDF 自动更新，正反向跳转也可用——这就是日常写作的工作流。

如果编译含中文文档时报错，检查两点：编译器是否切到了 latexmk (xelatex) recipe（见 4.2）；文档类是否用的是 ctexart 而非 article。