LaTeX 安装与配置

📅 2026/8/25 19:35:53
LaTeX 安装与配置
LaTeX 是一种基于 TeX 的排版系统使用前需要安装 TeX 发行版和编辑器。本章将介绍LaTeX 安装与配置适用于 Windows、macOS 和 Linux 系统。LaTeX 的安装Windows 系统在 Windows 系统上推荐使用MiKTeX或TeX Live来安装 LaTeX。安装 MiKTeX下载 MiKTeX访问 MiKTeX 官方网站下载适合你系统的安装程序。运行安装程序双击下载的安装程序按照提示进行安装。建议选择完整安装以确保所有常用宏包都已安装。配置环境变量安装完成后确保 MiKTeX 的bin目录已添加到系统的 PATH 环境变量中。这样可以在命令行中直接使用 LaTeX 命令。安装 TeX Live下载 TeX Live访问 TeX Live 官方网站下载适合你系统的安装程序。运行安装程序双击下载的安装程序按照提示进行安装。TeX Live 的安装过程较为耗时因为它包含了大量的宏包和工具。配置环境变量安装完成后确保 TeX Live 的bin目录已添加到系统的 PATH 环境变量中。macOS 系统在 macOS 系统上推荐使用MacTeX来安装 LaTeX。安装 MacTeX下载 MacTeX访问 MacTeX 官方网站下载适合你系统的安装程序。运行安装程序双击下载的.pkg文件按照提示进行安装。MacTeX 包含了 TeX Live 和相关的 GUI 工具。配置环境变量安装完成后确保 TeX Live 的bin目录已添加到系统的 PATH 环境变量中。Linux 系统在 Linux 系统上推荐使用TeX Live来安装 LaTeX。安装 TeX Live使用包管理器安装大多数 Linux 发行版都提供了 TeX Live 的包。你可以使用包管理器来安装。例如在 Ubuntu 上可以使用以下命令sudo apt-get install texlive-full这将安装完整的 TeX Live 发行版包括所有常用的宏包和工具。手动安装如果你需要最新版本的 TeX Live可以从 TeX Live 官方网站 下载安装脚本并手动安装。LaTeX 的配置编辑器选择LaTeX 文档是纯文本文件因此你可以使用任何文本编辑器来编写 LaTeX 代码。然而使用专门的 LaTeX 编辑器可以提高效率。以下是一些常用的 LaTeX 编辑器TeXstudio跨平台的 LaTeX 编辑器功能强大适合初学者和高级用户。Overleaf在线 LaTeX 编辑器无需安装适合协作和快速编辑。VS Code通用代码编辑器通过安装 LaTeX 插件如 LaTeX Workshop可以支持 LaTeX 编辑和编译。编译 LaTeX 文档LaTeX 文档需要通过编译生成最终的 PDF 文件。常用的编译命令有pdflatex生成 PDF 文件适合大多数文档。xelatex支持 Unicode 和 TrueType 字体适合处理中文文档。lualatex基于 Lua 的编译引擎支持现代字体和高级功能。编译命令的使用方式如下pdflatex mydocument.tex这将生成mydocument.pdf文件。处理中文文档如果你需要处理中文文档推荐使用xelatex或lualatex编译引擎并配合ctex宏包。以下是一个简单的 LaTeX 中文文档示例实例\documentclass[UTF8]{ctexart}\begin{document}你好世界\end{document}使用xelatex编译该文档xelatex mydocument.tex安装和管理宏包LaTeX 的宏包可以通过包管理器进行安装和管理。在 MiKTeX 和 TeX Live 中可以使用以下命令来安装宏包MiKTeX使用MiKTeX Console来搜索和安装宏包。TeX Live使用tlmgr命令来安装宏包。例如tlmgr install package-name编译流程LaTeX 的核心工作流程是你编写的 .tex 源文件 → 编译器如 pdfLaTeX → 生成 .pdf 文件编译过程中还会生成一些辅助文件如 .aux、.log、.toc它们用于记录目录、引用等信息通常不需要手动管理。常见的编译命令有pdflatex最常用直接生成 PDF但对中文和字体支持较弱xelatex支持系统字体和中文推荐中文用户使用lualatex功能更强大的新一代引擎速度稍慢第一个 Hello World 文档新建一个 .tex 文件输入以下内容\documentclass{article} \begin{document} Hello, World! 这是我的第一份 LaTeX 文档。 \end{document}保存后点击编译你将得到一份包含这句话的 PDF 文档。文档基本结构解析一份 LaTeX 文档通常分为两部分\documentclass{article} % 前导区Preamble设置文档类型、加载宏包 \begin{document} % 正文区实际显示的内容 正文内容写在这里 \end{document}前导区位于 \documentclass 与 \begin{document} 之间用于声明文档类型、引入宏包、定义全局设置这部分内容不会显示在最终 PDF 中正文区\begin{document} 到 \end{document} 之间的内容才是真正会被排版输出的部分常用文档类Document Class\documentclass{article} % 文章、短报告无章节 chapter \documentclass{report} % 长报告支持 chapter \documentclass{book} % 书籍支持双面排版、chapter \documentclass{letter} % 信件 \documentclass{beamer} % 演示文稿幻灯片可以通过方括号传入选项例如\documentclass[12pt, a4paper]{article}这表示使用 12pt 字号、A4 纸张排版。文档的基本结构每个 LaTeX 文档都由两部分组成导言区和正文区。\begin{document} 之前是导言区用来声明文档类、加载宏包、定义标题作者等全局设置。\begin{document} 与 \end{document} 之间是正文区标题、章节、文字、公式都写在这里。文档类决定了文档的整体形态在第一行 \documentclass 中声明。文档类用途典型场景article短文与论文无「章」级期刊论文、作业、小报告report有「章」层级的长报告实验报告、课程设计book书籍含前言、章、附录教材、专著ctexart / ctexrep / ctexbook上述三者的中文版任何中文文档直接选它beamer幻灯片学术演示第 12 篇专门讲文档类还可以带方括号选项比如指定字号和纸张实例带选项的文档类% 12pt正文字号 12 磅默认 10pt% a4paperA4 纸张默认 letterbox国内打印建议显式声明\documentclass[12pt, a4paper]{ctexart}第一个完整文档Hello World 太简单看不出 LaTeX 的价值。下面这份文档加入了标题区、列表和公式更接近日常使用。实例第一个完整文档\documentclass{ctexart}\usepackage{geometry} % 加载页面设置宏包必填于使用 \geometry 前\geometry{a4paper, margin2.5cm} % A4 纸四边页边距 2.5 厘米\title{我的第一份完整文档} % 标题\author{RUNOOB} % 作者\date{\today} % \today 自动填入编译当天日期\begin{document}\maketitle % 生成标题区标题、作者、日期居中展示你好\LaTeX{}这份文档由 XeLaTeX 编译生成。我喜欢用 LaTeX 做三件事\begin{itemize} % 无序列表环境\item 写数学公式例如勾股定理 $a^2 b^2 c^2$\item 自动生成章节编号和目录\item 让长文档保持格式统一。\end{itemize}\end{document}编译后的效果注意几个细节\maketitle 把导言区定义的标题信息渲染成标题区\today 自动生成了「2026 年 8 月 20 日」无需手写itemize 列表自动加了圆点。这些命令的具体规则会在后续几篇里逐一展开。常见问题排查第一次搭环境遇到问题是常态。下面收集了新手最高频的报错。现象原因解决办法中文显示空白或直接报错编译器不是 XeLaTeXOverleaf 在 Menu 里切换本地用 xelatex 命令编译Undefined control sequence命令拼写错误或用了未加载宏包的命令看日志定位行号检查拼写确认对应宏包已 \usepackageFile xxx.sty not found本地发行版缺少该宏包TeX Live 用 tlmgr install xxx 安装MiKTeX 通常会自动下载目录、引用显示为 ??只编译了一遍再编译一次Overleaf 编译超时免费版有资源限制精简文档或转本地编译