一种安装LaTeX的可能路径

2026-01-09

要入门LaTeX，我建议初学者使用这两本资料：《一份（不太）简短的 $\LaTeX\mathrm{2\varepsilon}$ 介绍》¹和《 $\LaTeX$ 入门》²。那里讲的比我这里丰富完整得多。

使用LaTeX有很多不同的配置方法，我在这里介绍我所使用的路径，即Windows 11系统下的TeX Live和VS Code的组合。这里可以把TeX Live理解为LaTeX软件系统的内核，我们选择用VS Code来编写LaTeX文档，然后调用这个内核来将我们的LaTeX代码翻译，最后输出PDF文件。

LaTeX简介和TeX Live下载

1978年，Knuth编制了 $\textbf{\TeX}$ 排版系统，这是一种电脑能够处理的低级语言，但大多数人发现它很难使用。为了让它变得更加易于上手，Lamport在其基础上设计了一套宏集，也就是 $\textbf{\LaTeX}$。所以说LaTeX是一种基于TeX的文档准备系统(Document Preparing System)。

如今的LaTeX早已不靠单独的程序运行，使用该系统时会涉及到各种排版引擎、编译脚本、字体、数以千计的宏包和文档等等。我们要安装的是TeX发行版，也就是把所有这样的部件都集合起来打包发布的软件。常见的发行版有CTeX，以及我们这里将要选择安装的TeX Live。

官方下载网址在此：https://tug.org/texlive/acquire-netinstall.html ，我操作系统是Windows 11，所以下载适用于Windows的最新的安装程序即可。不过因为官方服务器在国外下载速度经常都偏慢，所以可以使用国内的镜像下载源，比如清华镜像等等。

下载后得到一个好几个G大小的光盘映像文件，以管理员身份运行其中的install-tl-windows.exe安装程序，根据默认设置进行安装即可。安装时间会比较长。

VS Code简介和下载

Visual Studio Code是微软公司开发的跨平台源代码编辑器。本质上VS Code只是一个轻量的高度自由的文本编辑器，不过有很多开发者在这个平台上开发了各种各样的插件，从而可以实现多种语言的一站式开发。比如若是安装了Python的插件，就可以用VS Code编写甚至运行Pyhon程序。同样，首先访问官网进行免费下载，然后我们再在其中安装Latex的插件，就可以用VS Code来编辑LaTeX语言的文档了。

下载地址在此：https://code.visualstudio.com/Download 。进入VS Code，点击最左侧的“Extentions”（拓展），搜索并安装适用于LaTeX的拓展：LaTeX Workshop。

将拓展安装好后我们还需要做一些设置，也就是将VS Code和之前我们安装好的TeX Live连接在一起。

设置VS Code和LaTeX Workshop

前面说到VS Code是具有高度自由化的源代码编辑器，这是因为你可以对其做出各种各样的个性化设置。按下Ctrl+,进入VS Code的管理设置的图形化界面，在右上角找到“Open Settings (JSON)”，点击进入VS Code的管理设置的基础文件。所有关于VS Code本身及其拓展的设置都在这里以JSON格式的键值对体现，方便统一管理。

下面的对LaTeX Workshop的设置也不是唯一的，仅供参考。乐意折腾的同学可以移步该拓展的官方Wiki。

 1//------------------------------LaTeX 配置------------------------------
 2"latex-workshop.latex.autoBuild.run":"never",//自动编译：从不
 3"latex-workshop.showContextMenu":true,//右键菜单：打开
 4
 5// 编译出错时设置是否弹出气泡设置
 6"latex-workshop.message.error.show": true,
 7"latex-workshop.message.warning.show": true,
 8
 9// 编译工具和命令
10"latex-workshop.latex.tools": [
11    {
12        "name": "xelatex",
13        "command": "xelatex",
14        "args": [
15            "-synctex=1",
16            "-interaction=nonstopmode",
17            "-file-line-error",
18            "%DOCFILE%"
19        ]
20    },
21    {
22        "name": "pdflatex",
23        "command": "pdflatex",
24        "args": [
25            "-synctex=1",
26            "-interaction=nonstopmode",
27            "-file-line-error",
28            "%DOCFILE%"
29        ]
30    },
31    {
32        "name": "bibtex",
33        "command": "bibtex",
34        "args": [
35            "%DOCFILE%"
36        ]
37    }
38],
39
40// 配置编译链
41"latex-workshop.latex.recipes": [
42    {
43        "name": "XeLaTeX",
44        "tools": [
45            "xelatex"
46        ]
47    },
48    {
49        "name": "PDFLaTeX",
50        "tools": [
51            "pdflatex"
52        ]
53    },
54    {
55        "name": "BibTeX",
56        "tools": [
57            "bibtex"
58        ]
59    },
60    {
61        "name": "xelatex -> bibtex -> xelatex*2",
62        "tools": [
63            "xelatex",
64            "bibtex",
65            "xelatex",
66            "xelatex"
67        ]
68    },
69    {
70        "name": "pdflatex -> bibtex -> pdflatex*2",
71        "tools": [
72            "pdflatex",
73            "bibtex",
74            "pdflatex",
75            "pdflatex"
76        ]
77    }
78],
79
80"latex-workshop.latex.autoClean.run": "onFailed", //清除辅助文件：在构建失败后
81"latex-workshop.latex.recipe.default": "lastUsed", //默认使用的recipe编译组合：上次用的
82// "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click", //用于反向同步的内部阅读器的键绑定（按照默认即可）
83// "latex-workshop.latex.clean.fileTypes": ["*.ist",], //文件清理（按照默认即可）

正常来说，像这样设置好settings.json后，就可以愉快地在VS Code里编写.tex文档了，并且不用打开cmd命令行工具就可以直接在VS Code里调用“PDFLaTeX”“XeLaTeX”“BibTeX”等等工具来进行编译输出。

Tobias Oetiker, et al. 一份不太简短的 $\LaTeX\mathrm{2\varepsilon}$介绍——或111分钟学会 $\LaTeX\mathrm{2\varepsilon}$ [CP/OL]. 中文版本6.05. (2024-12-18)[2025-01-09]. https://github.com/CTeX-org/lshort-zh-cn
安装TeX Live后可在.../texmf-dist/doc/latex/lshort-chinese路径找到中文文档。 ↩︎
刘海洋. $\LaTeX$入门[M]. 北京:电子工业出版社,2013. ↩︎