本地LaTeX环境搭建指南：从TeX Live安装到编辑器配置

原创于 2026-08-11 11:08:03 发布 · 359 阅读 ·

本内容遵循CC 4.0 BY-SA版权协议

代码可运行

1. 从“劝退”到“真香”：为什么你需要一个本地的LaTeX环境

如果你正在写论文、准备技术报告，或者任何需要处理复杂公式和精美排版的文档，大概率听说过LaTeX。网上有很多在线的LaTeX编辑器，比如Overleaf，它们开箱即用，确实方便。但作为一个写过几篇论文、也折腾过不少工具的人，我必须说， 一个稳定、可控的本地LaTeX环境，带来的体验和效率提升是云端服务无法比拟的 。

首先，是 绝对的掌控感 。在线编辑器再好，也受制于网络和服务器的稳定性。在deadline前夜，网络波动或者平台维护带来的几十分钟无法访问，足以让人崩溃。本地环境则完全属于你，断网也能写，想用什么宏包就装什么，不受平台版本限制。其次，是 编译速度 。对于几十页、包含大量图表和参考文献的文档，本地编译通常比在线编译快得多，尤其是配合增量编译工具时，那种“秒出”预览的流畅感，是在线编辑难以提供的。最后，是 与专业工具的深度集成 。你可以用你最顺手的文本编辑器（如VS Code）或IDE（如TeXstudio）来编写，配合Git进行版本管理，打造一套完全个性化、高效的工作流。

很多人被LaTeX的“安装复杂”劝退，宁愿忍受在线编辑器的种种不便。其实，现在的LaTeX发行版安装已经非常傻瓜化，尤其是TeX Live。今天，我就以2022年的版本为例，手把手带你搭建一个功能完整、中英文通吃的本地LaTeX环境，并附上可靠的安装资源。整个过程，我会把每一步的意图、可能遇到的坑以及我的解决方案都讲清楚，让你一次成功，告别安装焦虑。

2. TeX Live 2022：你的LaTeX“全能工具箱”安装详解

TeX Live是TUG（TeX用户组）维护的跨平台LaTeX发行版，它不是一个软件，而是一个 包含了LaTeX核心引擎、成千上万个宏包、字体以及辅助工具的庞大集合 。安装它，就相当于一次性给你的电脑装上了LaTeX世界几乎所有的“乐高积木”。我们选择安装TeX Live 2022，是因为它是一个长期支持版本，非常稳定，兼容性极佳，足以应对绝大多数场景。

2.1 获取安装镜像：避开官网的“龟速”下载

最权威的下载源当然是TUG的官方服务器，但对于国内用户，直接从官网下载几个G的ISO镜像文件，速度可能非常不理想。因此，我们通常使用国内高校的镜像站，速度会快很多。

这里我推荐 清华大学开源软件镜像站 。它的资源同步及时，速度稳定。具体步骤如下：

打开浏览器，访问清华大学TUNA镜像站的TeX Live页面。你可以搜索“清华大学镜像站 texlive”找到它。
在页面中，找到“ISO映像文件”目录，进入后选择 texlive2022.iso 这个文件进行下载。这个文件大约有4.5GB，包含了完整的基础安装包。
下载完成后，你会得到一个 .iso 格式的镜像文件。在Windows上，你可以直接使用系统自带的“资源管理器”挂载它（Win10/11直接双击即可）；也可以使用解压软件（如7-Zip）将其解压到一个文件夹中。在macOS上，可以双击挂载；在Linux上，可以使用 mount 命令或直接挂载。

注意：请务必从可信的镜像站下载，避免下载到被篡改的安装包。清华大学、中国科技大学、北京大学的镜像站都是可靠的选择。

2.2 Windows平台安装：图形化安装器的每一个选项

对于Windows用户，安装过程是最直观的。挂载或解压ISO文件后，你会看到里面有一个 install-tl-windows.bat 批处理文件。 不要直接双击它 ，因为默认的cmd窗口可能权限不足。正确的做法是：

在Windows搜索栏输入“cmd”，找到“命令提示符”，然后 右键点击，选择“以管理员身份运行” 。这是为了避免后续安装字体、写入系统路径时遇到权限错误。
在打开的命令提示符窗口中，使用 cd 命令切换到你的ISO解压目录。例如，如果你的ISO解压到了 D:\texlive2022 ，就输入：
```
cd /d D:\texlive2022
```
然后运行安装批处理文件：
```
install-tl-windows.bat
```

这时会弹出一个图形化的安装向导。以下几个关键选项需要你仔细配置：

安装目录 ：默认是 C:\texlive\2022 。如果你C盘空间紧张，可以更改到其他盘符，比如 D:\texlive\2022 。路径中 不要包含中文或空格 ，这是很多软件的通病，LaTeX也不例外，避免未来产生诡异的错误。
安装方案 ：这里我强烈推荐选择“ 自定义（Customize） ”，而不是“完整（Full）”。完整安装会占用近8GB空间，其中很多宏包你可能一辈子都用不到。自定义安装允许我们勾选最核心的部分。
自定义安装内容 ：
- 在“集合（Collections）”选项卡中，确保勾选“ scheme-full ”。这个集合包含了LaTeX核心和绝大多数常用宏包，是性价比最高的选择。
- 在“语言（Language）”选项卡中， 务必勾选“Chinese, Japanese, Korean (extra)”以及“Chinese ”。这能确保中、日、韩文字的排版支持，特别是中文。只装英文支持的话，处理中文文档会非常麻烦。
- 其他集合如“音乐（Music）”、“字体（Fonts）”等，除非你确定需要，否则可以不选以节省空间。
创建快捷方式 ：建议勾选，方便以后访问。
安装后设置系统PATH ：这个选项 至关重要 ！请确保勾选“ 为所有用户添加TeX Live到系统PATH ”。这样，你才能在任意位置的命令行或脚本中直接调用 pdflatex , xelatex 等命令。如果安装时忘了勾选，后续需要手动添加，比较麻烦。

点击“安装”后，过程会比较漫长（可能1-2小时，取决于电脑性能），请耐心等待。安装程序会下载并解压成千上万个文件。完成后，建议 重启一次电脑 ，以确保环境变量生效。

2.3 Linux/macOS平台安装：终端下的精准控制

对于Linux和macOS用户，我们通常使用基于网络的安装脚本，这样可以选择只安装需要的部分，更为灵活。

下载安装脚本 ：同样从清华大学镜像站，找到 install-tl-unx.tar.gz 文件并下载解压。
终端准备 ：打开终端，进入解压后的目录。
执行安装 ：
```
# 首先赋予脚本执行权限
chmod +x install-tl
# 使用sudo以root权限运行，安装到系统目录
sudo ./install-tl
```
或者，如果你想安装到用户目录（无需sudo），可以：
```
./install-tl --profile=./texlive.profile
```
你可以编辑 texlive.profile 文件来预定义安装选项，比如安装路径、集合选择等。对于新手，直接运行 sudo ./install-tl 然后进入交互界面更直观。
交互界面配置 ：终端会显示一个文字交互界面。按 D 键可以更改安装目录（Linux下常见如 /usr/local/texlive/2022 ，macOS下也可用 /usr/local 或用户目录）。按 S 键进入方案选择，同样建议选择 C 自定义，然后进入菜单，确保选中了 scheme-full 和中文语言支持。配置完成后，按 I 键开始安装。
环境变量 ：安装完成后，TeX Live会提示你将它的 bin 目录添加到系统的PATH中。对于Linux，通常是在 ~/.bashrc 或 ~/.zshrc 文件末尾添加一行：
```
export PATH=/usr/local/texlive/2022/bin/x86_64-linux:$PATH
```
对于macOS，如果是bash，修改 ~/.bash_profile ；如果是zsh，修改 ~/.zshrc 。添加类似的行，注意路径要对应你的实际安装路径。然后执行 source ~/.zshrc （或对应的配置文件）使其立即生效。

安装后的验证 ：无论在哪个平台，安装完成后，请打开一个新的终端或命令提示符窗口，输入以下命令：

tex --version

如果正确显示TeX的版本信息（如 TeX 3.141592653 (TeX Live 2022) ），则说明安装成功，环境变量也已配置正确。

3. 编辑器的选择与配置：TeXstudio vs. VS Code

有了强大的TeX Live引擎，我们还需要一个称手的“编辑器”来编写 .tex 源文件。这里我重点对比两款最主流的选择： TeXstudio 和 VS Code 。它们代表了两种不同的风格，适合不同的人群。

3.1 TeXstudio：为LaTeX而生的“一站式”IDE

如果你希望一个开箱即用、功能专为LaTeX深度定制的工具，TeXstudio是你的不二之选。它内置了几乎所有LaTeX写作需要的功能。

安装与初步配置 ：

从TeXstudio官网或你的系统软件源安装。安装过程很简单，一路下一步即可。
首次启动后，最关键的一步是 配置编译器路径 。进入“选项” -> “设置TeXstudio” -> “命令”。
在这里，你需要确保各个编译命令指向刚刚安装的TeX Live 2022的二进制文件。例如， PdfLaTeX 一项应该类似于：
```
D:/texlive/2022/bin/win32/pdflatex.exe -synctex=1 -interaction=nonstopmode %.tex
```
（请根据你的实际安装路径调整）。通常TeXstudio能自动检测到TeX Live的安装，但手动检查一遍更保险。
在“构建”选项中，建议将默认编译器改为“ XeLaTeX ”。因为XeLaTeX对现代字体（尤其是系统字体）和Unicode（包括中文）的支持是最好的，能避免很多编码和字体问题。

TeXstudio的核心优势 ：

深度集成 ：语法高亮、代码补全、一键插入环境/命令、结构视图、内置PDF预览器且支持正向/反向搜索（点击PDF跳转到源码，点击源码跳转到PDF），这些功能无缝衔接。
项目管理 ：对于包含多个子文件的大型项目（如论文的每一章一个文件），管理起来非常方便。
错误辅助 ：编译出错时，错误信息会直接链接到源码的对应行，并给出可能的修正建议。

我的使用心得 ：TeXstudio的界面布局非常高效，左侧是文档结构/文件树，中间是编辑器，右侧是PDF预览。写论文时，我习惯用它的“向导”功能快速插入表格、图片、公式，效率极高。对于LaTeX新手和中级用户，它能极大降低学习曲线，让你更专注于内容而非工具。

3.2 VS Code + LaTeX Workshop：极客的个性化之选

如果你已经是VS Code的重度用户，或者喜欢高度可定制、能与多种编程语言工作流统一的环境，那么“VS Code + LaTeX Workshop插件”的组合将无比强大。

环境搭建步骤 ：

安装VS Code ：从官网下载安装即可。
安装LaTeX Workshop插件 ：在VS Code的扩展商店中搜索“LaTeX Workshop”，由James Yu开发的那个，安装并重启VS Code。
基本配置 ：插件安装后，基本功能已经可用。但为了获得最佳体验，我们需要进行一些配置。按下 Ctrl+Shift+P （Windows/Linux）或 Cmd+Shift+P （macOS），输入“Open Settings (JSON)”并选择，这会打开VS Code的用户设置JSON文件。

关键配置项 ：在JSON文件中添加或修改以下设置。这些配置定义了编译工具链、预览行为等：

{
  "latex-workshop.latex.tools": [
    {
      "name": "xelatex",
      "command": "xelatex",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "%DOCFILE%"
      ]
    },
    {
      "name": "latexmk",
      "command": "latexmk",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "-xelatex",
        "%DOC%"
      ]
    }
  ],
  "latex-workshop.latex.recipes": [
    {
      "name": "xelatex -> bibtex -> xelatex*2",
      "tools": [
        "xelatex",
        "bibtex",
        "xelatex",
        "xelatex"
      ]
    }
  ],
  "latex-workshop.view.pdf.viewer": "tab",
  "latex-workshop.latex.autoBuild.run": "onSave",
  "latex-workshop.latex.clean.fileTypes": [
    "*.aux",
    "*.bbl",
    "*.blg",
    "*.idx",
    "*.ind",
    "*.lof",
    "*.lot",
    "*.out",
    "*.toc",
    "*.acn",
    "*.acr",
    "*.alg",
    "*.glg",
    "*.glo",
    "*.gls",
    "*.ist",
    "*.fls",
    "*.log",
    "*.fdb_latexmk",
    "*.synctex.gz"
  ],
}

tools ：定义可用的编译命令。这里定义了 xelatex 单次编译和 latexmk 自动化编译（推荐）。
recipes ：定义编译流程。上面的配方实现了用XeLaTeX编译、处理BibTeX参考文献、再编译两次以确保交叉引用正确的标准流程。
viewer : 设置PDF在VS Code内置的标签页中打开，实现类似TeXstudio的内嵌预览。
autoBuild.run : 设置为 onSave 后，每次保存 .tex 文件都会自动触发编译，实时预览效果，非常流畅。
clean.fileTypes : 定义清理命令要删除的中间文件类型，保持项目整洁。

VS Code方案的优势 ：

统一环境 ：如果你也用VS Code写代码，所有快捷键、主题、扩展管理都是统一的，无需切换思维。
强大的编辑功能 ：VS Code本身的多光标、全局搜索替换、代码片段、版本控制（Git）集成等能力远超一般编辑器。
高度可定制 ：通过JSON配置，你可以打造完全符合个人习惯的LaTeX工作流，这是TeXstudio难以比拟的。
社区生态 ：可以结合其他插件，如Code Spell Checker检查拼写，GitLens管理版本，Todo Tree管理注释中的TODO项等。

个人建议 ： 新手可以从TeXstudio起步 ，它能帮你快速理解LaTeX项目的结构和编译流程，减少配置困扰。当你对LaTeX比较熟悉，并且希望更精细地控制工作流，或者本身就是VS Code用户时， 再迁移到VS Code+LaTeX Workshop ，你会感受到另一种效率巅峰。

4. 验证与初体验：编写你的第一个中文文档

环境装好了，编辑器也配置妥当了，是时候检验成果了。我们通过创建一个简单的、包含中文和数学公式的文档，来测试整个环境是否工作正常。

4.1 创建测试文档

在你的工作目录下，新建一个文本文件，命名为 test.tex 。用你选择的编辑器（TeXstudio或VS Code）打开它，输入以下内容：

% !TEX program = xelatex
\documentclass[UTF8]{ctexart}
\usepackage{amsmath}

\title{我的第一个\LaTeX 文档}
\author{你的名字}
\date{\today}

\begin{document}

\maketitle

\section{欢迎来到\LaTeX 世界}
这是一段包含\textbf{粗体}和\textit{斜体}的中文文本。LaTeX 能够优雅地处理中文排版，这得益于 \texttt{ctex} 宏包。

\section{数学公式测试}
行内公式：勾股定理表示为 \(a^2 + b^2 = c^2\)。

独立显示的公式：
\[
E = mc^2
\]

带编号的公式：
\begin{equation}
\label{eq:integral}
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
\end{equation}

公式(\ref{eq:integral})是一个著名的高斯积分。

\section{列表环境}
这是一个无序列表：
\begin{itemize}
    \item 项目一
    \item 项目二
    \item 项目三
\end{itemize}

这是一个有序列表：
\begin{enumerate}
    \item 第一步
    \item 第二步
    \item 第三步
\end{enumerate}

\end{document}

代码逐行解析 ：

% !TEX program = xelatex ：这是一个特殊的注释（对于VS Code的LaTeX Workshop插件尤其有用），告诉编辑器默认使用XeLaTeX引擎来编译此文件。在TeXstudio中，你可以在图形界面选择编译器。
\documentclass[UTF8]{ctexart} ：这是文档类的声明。我们使用 ctexart 文档类，它是专为中文文章设计的，基于标准的 article 类并集成了 ctex 宏包。 [UTF8] 选项指定使用UTF-8编码，这是现代文本文件的标准编码，完美支持中文。
\usepackage{amsmath} ：引入 amsmath 宏包，它提供了强大的数学公式排版功能，是写科技文档的必备宏包。
\title , \author , \date ：设置文档的标题、作者和日期。
\begin{document} ... \end{document} ：文档内容的开始和结束标记。所有可见内容都写在这对标签之间。
\maketitle ：生成标题区域。
\section{} ：创建章节标题。
\textbf{} , \textit{} ：分别用于生成粗体和斜体文本。
$ ... $ 和 \[ ... \] ：分别是行内数学公式和独立显示数学公式的环境。 equation 环境则会产生带自动编号的公式。
\label{} 和 \ref{} ：用于给公式（或章节、图表）打标签和引用标签，LaTeX会自动处理编号。
itemize 和 enumerate 环境：分别用于生成无序列表和有序列表。

4.2 编译与查看结果

在TeXstudio中，直接点击工具栏上的“构建并查看”（通常是一个绿色的单箭头）按钮。在VS Code中，保存文件后，由于我们设置了自动编译，侧边栏的LaTeX Workshop视图里应该会开始编译。你也可以按 Ctrl+Alt+B （默认快捷键）手动触发编译。

编译成功后，会自动打开生成的PDF文件。你应该能看到：

一个格式规范的标题，包含你设定的信息。
清晰的中文章节标题和正文，字体美观。
正确排版的数学公式，包括行内公式和独立公式，并且公式编号和引用功能正常。
整齐的无序和有序列表。

如果PDF成功生成且内容正确，那么恭喜你，你的LaTeX 2022环境已经 完全配置成功 ！你拥有了一个能处理复杂中文排版和数学公式的强力工具。

4.3 可能遇到的问题与排查

编译失败，提示“字体未找到”或“无法生成PDF” ：
- 检查编译器 ：确保你使用的是 XeLaTeX 或 LuaLaTeX 。传统的PDFLaTeX对中文字体支持不佳。在TeXstudio的设置中确认默认编译器，在VS Code中确认 % !TEX program 指令或工具链配置。
- 检查编码 ：确保你的 .tex 文件以 UTF-8 without BOM 编码保存。几乎所有现代编辑器都默认如此，但如果你从别处拷贝了代码，最好检查一下。
- 检查宏包 ： ctex 宏包是TeX Live完整安装的一部分。如果提示找不到，可能是TeX Live安装不完整，尝试用TeX Live Manager（ tlmgr ）安装： tlmgr install ctex 。
PDF预览中中文显示为空白或乱码 ：
- 这几乎可以肯定是字体问题。 ctex 宏包默认会调用系统中易获取的中文字体（如Windows的宋体、黑体）。如果系统缺少字体，它会尝试使用TeX Live自带的字体。确保安装时勾选了中文语言支持。如果问题依旧，可以在文档导言区显式指定字体：
```
\setCJKmainfont{SimSun} % Windows 宋体
% \setCJKmainfont{STSong} % macOS 华文宋体
```
反向搜索（从PDF点击跳回源码）不工作 ：
- 这需要编译时生成 .synctex.gz 文件。确保你的编译命令中包含 -synctex=1 参数（我们在配置中已经添加）。在TeXstudio和VS Code LaTeX Workshop中，通常默认开启。在PDF阅读器中，可能需要特定的快捷键（如Ctrl+点击）来触发。

5. 进阶配置与资源推荐：打造得心应手的工作流

基础环境搭建好后，我们可以进行一些进阶配置，并了解一些优质资源，让你的LaTeX写作体验更上一层楼。

5.1 包管理器：tlmgr的使用

TeX Live自带了一个强大的命令行包管理器 tlmgr （TeX Live Manager）。你可以用它来搜索、安装、更新或移除宏包。

更新tlmgr自身和宏包索引 （建议定期进行）：
```
tlmgr update --self
tlmgr update --all
```
搜索宏包 ：如果你不知道某个功能对应哪个宏包，可以搜索：
```
tlmgr search --global --file "/tikz.sty"
```
安装宏包 ：例如，安装用于绘制化学式的 mhchem 宏包：
```
tlmgr install mhchem
```
设置镜像以加速 （国内用户必做）：默认源可能很慢。可以设置为国内镜像，如清华源：
```
tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet
```

注意：在Windows下，需要在“以管理员身份运行”的命令提示符中执行这些命令；在Linux/macOS下，可能需要 sudo 。

5.2 参考文献管理：BibTeX与Biber

学术写作离不开参考文献。LaTeX的标准流程是使用BibTeX或更新的Biber引擎配合 biblatex 宏包。

创建 .bib 文件 ：这是一个纯文本数据库文件，每条记录是一个参考文献条目，有唯一的引用键（key）。你可以用JabRef、Zotero（配合Better BibTeX插件）等软件管理，也可以手动编写。
```
@article{knuth1984,
  title={Literate Programming},
  author={Knuth, Donald E.},
  journal={The Computer Journal},
  volume={27},
  number={2},
  pages={97--111},
  year={1984}
}
```

在.tex文件中引用 ：

\usepackage[style=gb7714-2015]{biblatex} % 使用biblatex，并指定国标样式
\addbibresource{myrefs.bib} % 指定.bib文件
...
这里引用一篇文章\cite{knuth1984}。
...
\printbibliography % 生成参考文献列表

编译流程 ：使用 latexmk 工具（我们在VS Code配置中已经用了）可以自动处理复杂的多轮编译（XeLaTeX -> Biber -> XeLaTeX -> XeLaTeX）。手动的话，顺序是：
```
xelatex main.tex
biber main
xelatex main.tex
xelatex main.tex
```

5.3 实用资源与学习路径

离线文档 ：TeX Live安装后，本地就有一个庞大的文档库。在命令行输入 texdoc lshort-zh 可以打开一份非常优秀的《一份（不太）简短的LaTeX介绍》中文版，适合入门。输入 texdoc ctex 查看ctex宏包文档。
在线社区与问答 ：
- CTeX社区 ：国内老牌的LaTeX社区，有丰富的资源和讨论。
- Stack Exchange - TeX - LaTeX ：全球最专业的LaTeX问答网站，几乎你遇到的所有问题都能在这里找到答案。提问前请先搜索。
模板资源 ：
- Overleaf模板库 ：即使不用Overleaf，其模板库也是一个巨大的宝库，你可以下载模板到本地使用。
- 各大高校毕业论文模板 ：很多国内外大学都提供了官方的LaTeX论文模板，这是最权威的格式参考。
学习建议 ：不要试图一次性记住所有命令。从一个小文档开始，遇到需求（比如插入表格、图片、公式）时，再去查资料（如《lshort-zh》或网络搜索）。多用、多练，自然就熟了。对于复杂表格，可以先用在线工具生成代码框架再修改。

安装LaTeX环境看似步骤繁多，但一旦搭建完成，它就是一个一劳永逸的、强大且稳定的科研写作基础。希望这篇详尽的指南能帮你顺利跨过安装的门槛，真正享受LaTeX带来的排版之美和写作之悦。如果在安装过程中遇到任何本指南未覆盖的奇特问题，记住万能法宝：仔细阅读终端或日志文件（.log）中的错误信息，并把它复制到搜索引擎（或Stack Exchange）中，你几乎肯定能找到解决方案。

标签

#LaTeX #TeX Live #本地环境