1. 项目概述为什么是LaTeX如果你还在用Word、WPS这类所见即所得的软件来写论文、报告或者技术文档尤其是涉及到大量数学公式、交叉引用和复杂排版的时候我猜你一定经历过格式突然崩溃、编号对不上、或者导师/审稿人一句“格式不规范”让你一夜回到解放前的痛苦。我当年写硕士论文时用Word调整一个公式的位置结果后面三页的图表全乱了那种绝望感至今记忆犹新。后来被师兄安利了LaTeX才算是真正找到了学术写作的“正道”。LaTeX发音“拉泰赫”或“雷泰克”本质上不是一个软件而是一个基于TeX的排版系统。你可以把它理解为一个极其严谨、高度自动化的“排版编程语言”。你用纯文本写下文章内容和排版指令然后“编译”这个文本文件LaTeX引擎就会严格按照你设定的规则或者你选择的模板规则生成一个格式完美、印刷级质量的PDF文档。它的核心优势在于“内容与格式分离”你只需要关心写什么至于章节怎么编号、公式怎么对齐、参考文献怎么排序LaTeX都帮你自动搞定而且保证全局一致。那么要使用LaTeX第一步就是搭建环境而TeX Live就是目前最主流、最完整的LaTeX发行版。它不是一个单一的软件而是一个包含了LaTeX引擎、宏包、字体、文档等几乎所有你需要的东西的“全家桶”。无论你是Windows、macOS还是Linux用户安装好TeX Live就等于拥有了一个功能完备的LaTeX工作站。接下来我就带你从零开始彻底搞定TeX Live的安装与配置并分享一些我踩过无数坑才总结出来的实战经验。2. 核心需求解析我们到底需要什么在动手安装之前我们先得搞清楚安装TeX Live到底是为了满足哪些核心需求。这能帮助你在后续遇到选择时做出正确的判断。2.1 稳定与完整学术写作的基石学术写作尤其是学位论文、期刊投稿容错率极低。你的文档可能在你自己电脑上看起来完美但一旦交给导师、合作者或者投稿系统就可能因为缺少某个不起眼的宏包而编译失败。TeX Live的最大优势就在于其完整性。它包含了CTANComprehensive TeX Archive Network上绝大多数宏包数量成千上万。这意味着当你使用某个冷门的数学符号宏包如physics或某个特定领域的绘图工具如tikz时有极大的概率它已经躺在你的硬盘里了无需联网下载。这种“开箱即用”的体验为稳定编译提供了最基础的保障。注意有些教程会推荐安装“基础版”或“在线安装版”以节省空间。对于严肃的学术工作者我强烈反对。一次完整的本地安装约8GB换来的是未来数年里无需担忧依赖问题的安心感这笔“空间投资”绝对划算。2.2 跨平台一致性协作无忧LaTeX文件是纯文本文件.tex这本身就具备了跨平台的优势。但光有.tex文件不够还需要底层的引擎和宏包一致。TeX Live在各个操作系统上提供几乎相同的组件和版本。这意味着你在Windows上用TeX Live 2024写的文档发给在macOS上用TeX Live 2024的同事几乎可以保证编译结果一模一样。这种一致性在多人协作、共同撰写论文时至关重要避免了“在我这好好的到你那就乱码”的尴尬。2.3 长期维护与社区支持TeX Live由TUGTeX Users Group维护每年发布一个新版本并提供数年的更新支持。它有庞大的用户社区和详尽的文档。当你遇到一个古怪的编译错误时搜索引擎大概率会将你引向TeX Live相关的解决方案。选择TeX Live就是选择了一个经过时间检验、有强大后盾的生态而不是一个可能突然停止更新的小众工具。3. 安装前的准备与方案选型知道了“为什么”接下来就是“怎么做”。TeX Live的安装主要有两种方式使用官方安装程序或者使用系统包管理器。选择哪种取决于你的操作系统和使用习惯。3.1 操作系统与安装器选择对于Windows用户这是最直接的场景。前往TeX Live官网下载install-tl-windows.exe这个安装程序。它提供了一个图形界面GUI向导对新手非常友好。但这里有一个关键决策点是否修改安装路径默认情况下安装程序会建议安装到C:\texlive\2024年份会变。如果你的C盘空间充足建议预留至少10GB我推荐就使用默认路径。因为很多LaTeX编辑器如TeXstudio会默认搜索这个位置。如果你必须安装到D盘等其他位置请务必记住完整的路径因为在后续配置编辑器时你需要手动指定这个路径。对于macOS用户你有两个主流选择使用MacTeX这是为macOS量身定制的TeX Live发行版额外包含了一些macOS特有的工具如BibDesk参考文献管理工具和原生GUI安装程序。对于绝大多数用户尤其是新手直接下载MacTeX.pkg安装是首选省心省力。使用Homebrew如果你是一名开发者习惯使用命令行管理软件那么可以通过Homebrew安装brew install --cask mactex。这种方式同样安装的是MacTeX但通过包管理器管理更新和卸载更方便。对于Linux用户最推荐的方式是使用系统自带的包管理器。例如Ubuntu/Debian:sudo apt install texlive-fullFedora:sudo dnf install texlive-scheme-fullArch Linux:sudo pacman -S texlive-most(或texlive-core基础版)使用包管理器安装的优点是能与系统其他软件一起更新。但需要注意发行版仓库中的TeX Live版本可能不是最新的通常会滞后几个月到一年。对于追求最新宏包或需要特定版本匹配的用户也可以从官网下载Unix安装脚本进行安装。3.2 安装选项详解不要无脑点“下一步”无论使用哪种安装器都会遇到一些选项。以Windows安装程序为例安装模式通常有“简单”Simple和“自定义”Custom两种。对于新手选“简单”即可它会安装所有架构win32, x64和所有预定义的集合collections。对于高级用户“自定义”模式允许你勾选或取消某些宏包集合以节省空间但我不建议新手这么做漏装宏包的痛苦远大于节省的几GB空间。创建快捷方式建议勾选“在开始菜单创建快捷方式”和“将TeX Live添加到系统PATH”。特别是添加到PATH这是最关键的一步。它允许你在任何命令行窗口如CMD、PowerShell中直接使用pdflatex,xelatex等命令。很多高级工具和脚本依赖于此。安装后操作安装程序可能会问你是否在安装后立即更新。由于安装包本身已经是最新发布版首次安装可以跳过此步等安装完成后再通过其自带的包管理器tlmgr进行更新。4. 安装实操全流程记录以Windows为例下面我以Windows平台为例展示一个完整的、带有详细注释的安装过程。macOS和Linux用户虽然界面不同但核心逻辑是相通的。4.1 下载与启动首先访问TeX Live官网的下载页面。由于官网镜像众多选择一个地理位置离你较近的镜像站如国内的清华、阿里云镜像下载install-tl-windows.exe。下载完成后右键点击该文件选择“以管理员身份运行”。这是为了避免在安装过程中因权限不足导致写入系统目录失败。4.2 图形界面安装步骤分解安装程序启动后你会看到一个命令行窗口闪过然后出现图形界面。欢迎界面直接点击“下一步”。许可协议阅读并点击“我接受”下一步。安装设置这是核心页面。安装目录如前所述除非C盘空间告急否则保持默认C:\texlive\2024。安装集合选择“完整安装Full installation”。下方的“自定义”选项会展开一个巨大的树状列表列出了所有宏包集合如“基础”、“数学”、“字体”、“人文”等。除非你非常清楚自己在做什么否则不要动这里。创建快捷方式确保“创建开始菜单条目”和“将TeX Live加入到系统PATH中”都被勾选。对于“将TeX Live加入到系统PATH中”有一个下拉选项选择“对所有用户”如果你有管理员权限或“仅对当前用户”。纸张设置默认是A4纸这符合中国及大多数国家的标准无需修改。安装前预览安装程序会展示你的选择摘要。仔细核对安装路径和“添加到PATH”的选项。确认无误后点击“安装”。安装过程接下来就是漫长的文件复制和解压过程。完整安装需要下载并解压约8GB的数据根据你的网速和硬盘速度可能需要30分钟到2小时。期间你可以去做别的事情但最好保持电脑通电和网络连接稳定。安装完成安装结束后点击“关闭”。非常重要的一步关闭所有命令行窗口和可能的编辑器然后重启你的电脑。这是为了让系统PATH环境变量的更改生效。4.3 验证安装是否成功重启后我们需要验证安装是否真正成功特别是PATH是否配置正确。打开“命令提示符”CMD或 PowerShell。输入命令tex --version并回车。如果安装成功且PATH配置正确你会看到类似如下的输出显示了TeX Live的版本信息和版权声明TeX 3.141592653 (TeX Live 2024) kpathsea version 6.3.5 Copyright 2024 D.E. Knuth. ...再测试一下LaTeX引擎输入pdflatex --version和xelatex --version。它们也应该能正确输出版本信息。如果这些命令返回“不是内部或外部命令”的错误说明PATH没有正确添加。你需要手动检查环境变量在系统设置中搜索“环境变量”编辑“Path”添加一条新记录值为你的TeX Live安装目录下的bin\win32或bin\win64例如C:\texlive\2024\bin\win64。保存后重新打开命令提示符再测试。5. 核心工具链配置与初步使用安装好TeX Live只是拥有了引擎就像有了汽车发动机你还需要方向盘和仪表盘编辑器来驾驶。同时了解核心编译命令是驾驭LaTeX的基础。5.1 编译引擎的选择pdflatex, xelatex, lualatexTeX Live自带多个编译引擎最常用的是这三个pdflatex最传统、最稳定、编译速度最快的引擎。它直接生成PDF但不支持系统字体只能使用TeX自带的字体或安装的字体包对中文等非拉丁文字支持需要额外配置如使用CJK宏包。适合纯英文、无需复杂字体的文档。xelatex目前中文用户的绝对主力。它原生支持Unicode和操作系统安装的TrueType/OpenType字体。这意味着你可以直接在文档中使用“宋体”、“微软雅黑”等系统字体对中文、日文等东亚文字支持完美。编译速度比pdflatex稍慢但完全可接受。lualatex基于Lua脚本引擎是最现代、功能最强大的引擎。它同样支持系统字体并且由于Lua的扩展性可以实现更复杂的排版功能如动态内容处理。编译速度相对最慢是未来发展的方向。实操心得对于新手尤其是中文用户我建议从xelatex开始。它平衡了功能、易用性和兼容性。你可以在文档开头通过\documentclass命令后使用\usepackage{fontspec}来轻松指定中文字体。5.2 编辑器的选择与配置你可以用记事本写LaTeX代码但那无疑是自讨苦吃。一个好的编辑器能提供语法高亮、命令补全、一键编译、错误跳转、实时预览等功能。TeXstudio免费、开源、功能全面对新手非常友好。安装后它通常能自动检测到TeX Live。如果没有你需要手动配置选项-设置TeXstudio-命令检查TeX路径下的pdflatex,xelatex等命令是否指向了TeX Live的bin目录。Visual Studio Code (VSCode) LaTeX Workshop插件这是目前很多开发者和进阶用户的首选。VSCode本身轻量强大LaTeX Workshop插件提供了极其专业的LaTeX支持。安装插件后需要配置settings.json。一个关键配置是告诉插件使用xelatexlatex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ], latex-workshop.latex.recipes: [ { name: xelatex - bibtex - xelatex*2, tools: [xelatex, bibtex, xelatex, xelatex] } ]这个“配方”recipe定义了一个完整的编译流程先用xelatex编译生成aux文件然后用bibtex处理参考文献再连续两次用xelatex确保引用和目录正确。Overleaf一个在线的LaTeX编辑器。它无需本地安装任何东西打开浏览器就能写并且内置了完整的TeX Live环境。非常适合协作、轻量使用或者在多台电脑间同步。但对于大型项目、需要自定义宏包或离线工作本地环境仍是必须。5.3 你的第一个LaTeX文档让我们用最经典的“Hello, World!”来测试整个环境。打开你的编辑器以TeXstudio为例新建一个文件输入以下内容% 指定文档类为article使用UTF-8编码 \documentclass[UTF8]{article} % 引入必要的宏包fontspec用于支持系统字体xeCJK用于中文字体处理 \usepackage{fontspec} \usepackage{xeCJK} % 设置中文字体请确保你的系统有这些字体 \setCJKmainfont{SimSun} % 宋体 \setCJKsansfont{Microsoft YaHei} % 微软雅黑 \setCJKmonofont{SimHei} % 黑体 % 文档开始 \begin{document} \title{我的第一个\LaTeX 文档} \author{你的名字} \date{\today} \maketitle \section{引言} 你好世界这是一个简单的\LaTeX 文档示例。 \section{数学公式} 行内公式勾股定理 $a^2 b^2 c^2$。 行间公式 \[ E mc^2 \] \section{列表} \begin{itemize} \item 无序列表项一 \item 无序列表项二 \end{itemize} \begin{enumerate} \item 有序列表项一 \item 有序列表项二 \end{enumerate} \end{document}保存文件命名为hello.tex。在TeXstudio的工具栏上将编译引擎切换到XeLaTeX通常在工具栏中间有一个下拉菜单然后点击绿色的“编译并查看”箭头。如果一切顺利右侧预览窗口将显示一个排版精美的PDF包含了标题、章节、公式和列表。6. 包管理器tlmgr的使用指南TeX Live的强大之处在于其庞大的宏包生态。虽然完整安装已经包含了绝大多数宏包但宏包会更新偶尔你也需要安装一个极其冷门的、未被包含在默认集合中的宏包。这时就需要用到TeX Live自带的包管理器——tlmgrTeX Live Manager。6.1 基本操作更新、搜索、安装tlmgr是一个命令行工具。请以管理员身份Windows或使用sudoLinux/macOS打开命令行。更新tlmgr自身和宏包数据库在安装任何新东西之前先更新本地数据库是个好习惯。tlmgr update --self tlmgr update --all第一条命令更新tlmgr自己第二条命令更新所有已安装的宏包到最新版本。搜索宏包如果你不知道某个功能对应哪个宏包可以搜索。tlmgr search --global --file /tikz这个命令会搜索所有包含“tikz”字符串的宏包。--global表示搜索所有集合--file表示按文件名搜索。安装宏包假设你需要安装minted宏包用于高亮显示代码。tlmgr install minted安装后你就可以在文档中使用\usepackage{minted}了。注意minted宏包依赖Python的Pygments库你还需要用pip install Pygments安装它这就是LaTeX宏包有时会有的外部依赖。卸载宏包谨慎使用tlmgr remove minted6.2 镜像源切换加速下载默认的官方镜像可能在国外下载更新速度很慢。我们可以将其切换到国内镜像源如清华TUNA镜像。Windows打开tlmgr-guiTeX Live Manager的图形界面可以在开始菜单找到在操作菜单下选择载入其他网络仓库输入镜像地址https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet然后点击“确定”。之后的操作就会从这个镜像进行了。命令行适用于所有平台tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet执行此命令后再运行tlmgr update --self等命令就会使用清华镜像。注意事项切换镜像源后如果遇到“仓库不匹配”的错误可能需要先使用tlmgr update --self --repository https://mirror.ctan.org/systems/texlive/tlnet从官方源更新tlmgr自身然后再切换回国内镜像。这是一个经典的“鸡生蛋”问题。7. 常见问题与排查技巧实录即使按照步骤安装在实际使用中仍会遇到各种问题。下面是我总结的一些高频问题及其解决方案。7.1 编译错误排查流程当点击编译后出现错误不要慌张。遵循以下排查流程看错误信息编译器如xelatex会在输出窗口或命令行给出错误信息通常以!开头。错误信息的第一行往往指出了错误类型和出错的宏包或命令。定位错误行错误信息里会包含文件名和行号例如l.25表示第25行。编辑器如TeXstudio, VSCode通常会高亮错误行或提供一键跳转。分析常见错误File ended while scanning use of \xxx通常是因为缺少闭合的括号}、花括号}或环境结束语句\end{xxx}。检查错误行附近的结构是否完整。Undefined control sequence.你使用了一个未定义的命令。最常见的原因是拼写错误如\usepackge应为\usepackage或者没有引入所需的宏包。**LaTeX Error: Filexxx.sty not found.**缺少名为xxx的宏包。你需要用tlmgr install xxx安装它。**Fontxxx not found.**使用xelatex时系统找不到你指定的字体。检查字体名是否拼写正确区分大小写或者该字体是否确实安装在你的系统中。可以用fc-list命令Linux/macOS或在系统字体设置里查看可用字体名。使用最小工作示例MWE这是调试LaTeX问题的黄金法则。当你遇到一个复杂错误时新建一个最简单的.tex文件只包含能复现错误的最少代码。这能排除文档其他部分的干扰也方便你向他人求助时提供清晰的代码。7.2 特定问题解决方案速查表问题现象可能原因解决方案编译后PDF中中文显示为空白或乱码1. 未使用xelatex或lualatex引擎。2. 未正确引入fontspec和xeCJK宏包。3. 指定的中文字体不存在或名称错误。1. 确保编译器是xelatex。2. 在导言区添加\usepackage{fontspec}和\usepackage{xeCJK}。3. 使用\setCJKmainfont{字体名}指定一个系统中确实存在的字体如SimSun。参考文献引用显示为问号[?]文献数据库.bib文件未被处理或编译流程不完整。完整的编译流程应为xelatex-bibtex/biber-xelatex-xelatex。在编辑器中设置正确的编译“配方”recipe。插入的图片找不到1. 图片文件路径错误或文件名错误包括扩展名。2. 图片文件格式不支持LaTeX原生支持.pdf,.jpg,.png等但需要graphicx宏包。3. 使用了相对路径但工作目录不对。1. 检查\includegraphics命令中的路径和文件名。2. 确保导言区有\usepackage{graphicx}。3. 将图片文件放在与.tex文件相同的目录下或使用绝对路径。对于复杂项目建议使用\graphicspath{{figures/}}命令设置图片搜索路径。数学公式渲染异常或报错1. 数学环境使用错误如$...$写在了段落外。2. 使用了未引入的数学符号宏包中的命令。1. 确保行内公式用$...$包裹行间公式用\[...\]或equation环境。2. 如需特殊符号如\mathbb用于黑板粗体引入amsfonts或amssymb宏包。编译速度异常缓慢1. 文档非常长且复杂。2. 使用了minted等需要调用外部程序的宏包。3. 杀毒软件或实时保护干扰。1. 使用\includeonly{}命令只编译当前正在撰写的章节。2. 对于minted可以先用-shell-escape参数编译一次生成缓存后续编译会快很多。3. 将LaTeX编译器的临时目录如_minted*添加到杀毒软件的白名单。7.3 关于“下载PDF乱码/公式乱码”的深度解析网络热词中提到了“latex 下载pdf乱码”和“latex 下载pdf 公式乱码”这是一个非常典型的问题根源通常不在LaTeX本身而在查看器或生成过程。字体嵌入问题如果你使用了系统字体通过fontspec而编译后的PDF没有完全嵌入这些字体那么在其他没有安装该字体的电脑上打开时就会用其他字体替代导致乱码或版式错乱。解决方案确保编译引擎如xelatex正确嵌入了字体。通常xelatex默认会嵌入所用字体。你可以用PDF阅读器如Adobe Acrobat的“文件”-“属性”-“字体”菜单检查PDF中使用的字体是否显示为“已嵌入子集”。PDF阅读器不兼容有些轻量级的PDF阅读器特别是某些浏览器内置的预览插件对复杂字体或特殊编码的PDF支持不佳。解决方案换用专业的PDF阅读器打开如Adobe Acrobat Reader、Foxit Reader或macOS自带的“预览”应用。这是排查此类问题的第一步。编译引擎选择错误用pdflatex处理包含中文字符的文档如果不配合特殊的宏包如CJK进行复杂配置必然产生乱码。解决方案对中文文档始终使用xelatex或lualatex。源代码文件编码问题你的.tex文件本身保存的编码不是UTF-8而编辑器或编译器却以UTF-8去解读导致乱码。解决方案确保你的编辑器如VSCode、TeXstudio将文件编码设置为UTF-8 without BOM。在文档类选项中声明[UTF8]如\documentclass[UTF8]{article}也是一个好习惯。我个人在协作中遇到对方打开我的PDF显示乱码时首先会问他用的什么阅读器然后让他用Acrobat Reader再试一次。十有八九问题就解决了。如果还有问题我会检查我本地的编译日志确认字体是否成功嵌入。
1. 项目概述为什么是LaTeX如果你还在用Word、WPS这类所见即所得的软件来写论文、报告或者技术文档尤其是涉及到大量数学公式、交叉引用和复杂排版的时候我猜你一定经历过格式突然崩溃、编号对不上、或者导师/审稿人一句“格式不规范”让你一夜回到解放前的痛苦。我当年写硕士论文时用Word调整一个公式的位置结果后面三页的图表全乱了那种绝望感至今记忆犹新。后来被师兄安利了LaTeX才算是真正找到了学术写作的“正道”。LaTeX发音“拉泰赫”或“雷泰克”本质上不是一个软件而是一个基于TeX的排版系统。你可以把它理解为一个极其严谨、高度自动化的“排版编程语言”。你用纯文本写下文章内容和排版指令然后“编译”这个文本文件LaTeX引擎就会严格按照你设定的规则或者你选择的模板规则生成一个格式完美、印刷级质量的PDF文档。它的核心优势在于“内容与格式分离”你只需要关心写什么至于章节怎么编号、公式怎么对齐、参考文献怎么排序LaTeX都帮你自动搞定而且保证全局一致。那么要使用LaTeX第一步就是搭建环境而TeX Live就是目前最主流、最完整的LaTeX发行版。它不是一个单一的软件而是一个包含了LaTeX引擎、宏包、字体、文档等几乎所有你需要的东西的“全家桶”。无论你是Windows、macOS还是Linux用户安装好TeX Live就等于拥有了一个功能完备的LaTeX工作站。接下来我就带你从零开始彻底搞定TeX Live的安装与配置并分享一些我踩过无数坑才总结出来的实战经验。2. 核心需求解析我们到底需要什么在动手安装之前我们先得搞清楚安装TeX Live到底是为了满足哪些核心需求。这能帮助你在后续遇到选择时做出正确的判断。2.1 稳定与完整学术写作的基石学术写作尤其是学位论文、期刊投稿容错率极低。你的文档可能在你自己电脑上看起来完美但一旦交给导师、合作者或者投稿系统就可能因为缺少某个不起眼的宏包而编译失败。TeX Live的最大优势就在于其完整性。它包含了CTANComprehensive TeX Archive Network上绝大多数宏包数量成千上万。这意味着当你使用某个冷门的数学符号宏包如physics或某个特定领域的绘图工具如tikz时有极大的概率它已经躺在你的硬盘里了无需联网下载。这种“开箱即用”的体验为稳定编译提供了最基础的保障。注意有些教程会推荐安装“基础版”或“在线安装版”以节省空间。对于严肃的学术工作者我强烈反对。一次完整的本地安装约8GB换来的是未来数年里无需担忧依赖问题的安心感这笔“空间投资”绝对划算。2.2 跨平台一致性协作无忧LaTeX文件是纯文本文件.tex这本身就具备了跨平台的优势。但光有.tex文件不够还需要底层的引擎和宏包一致。TeX Live在各个操作系统上提供几乎相同的组件和版本。这意味着你在Windows上用TeX Live 2024写的文档发给在macOS上用TeX Live 2024的同事几乎可以保证编译结果一模一样。这种一致性在多人协作、共同撰写论文时至关重要避免了“在我这好好的到你那就乱码”的尴尬。2.3 长期维护与社区支持TeX Live由TUGTeX Users Group维护每年发布一个新版本并提供数年的更新支持。它有庞大的用户社区和详尽的文档。当你遇到一个古怪的编译错误时搜索引擎大概率会将你引向TeX Live相关的解决方案。选择TeX Live就是选择了一个经过时间检验、有强大后盾的生态而不是一个可能突然停止更新的小众工具。3. 安装前的准备与方案选型知道了“为什么”接下来就是“怎么做”。TeX Live的安装主要有两种方式使用官方安装程序或者使用系统包管理器。选择哪种取决于你的操作系统和使用习惯。3.1 操作系统与安装器选择对于Windows用户这是最直接的场景。前往TeX Live官网下载install-tl-windows.exe这个安装程序。它提供了一个图形界面GUI向导对新手非常友好。但这里有一个关键决策点是否修改安装路径默认情况下安装程序会建议安装到C:\texlive\2024年份会变。如果你的C盘空间充足建议预留至少10GB我推荐就使用默认路径。因为很多LaTeX编辑器如TeXstudio会默认搜索这个位置。如果你必须安装到D盘等其他位置请务必记住完整的路径因为在后续配置编辑器时你需要手动指定这个路径。对于macOS用户你有两个主流选择使用MacTeX这是为macOS量身定制的TeX Live发行版额外包含了一些macOS特有的工具如BibDesk参考文献管理工具和原生GUI安装程序。对于绝大多数用户尤其是新手直接下载MacTeX.pkg安装是首选省心省力。使用Homebrew如果你是一名开发者习惯使用命令行管理软件那么可以通过Homebrew安装brew install --cask mactex。这种方式同样安装的是MacTeX但通过包管理器管理更新和卸载更方便。对于Linux用户最推荐的方式是使用系统自带的包管理器。例如Ubuntu/Debian:sudo apt install texlive-fullFedora:sudo dnf install texlive-scheme-fullArch Linux:sudo pacman -S texlive-most(或texlive-core基础版)使用包管理器安装的优点是能与系统其他软件一起更新。但需要注意发行版仓库中的TeX Live版本可能不是最新的通常会滞后几个月到一年。对于追求最新宏包或需要特定版本匹配的用户也可以从官网下载Unix安装脚本进行安装。3.2 安装选项详解不要无脑点“下一步”无论使用哪种安装器都会遇到一些选项。以Windows安装程序为例安装模式通常有“简单”Simple和“自定义”Custom两种。对于新手选“简单”即可它会安装所有架构win32, x64和所有预定义的集合collections。对于高级用户“自定义”模式允许你勾选或取消某些宏包集合以节省空间但我不建议新手这么做漏装宏包的痛苦远大于节省的几GB空间。创建快捷方式建议勾选“在开始菜单创建快捷方式”和“将TeX Live添加到系统PATH”。特别是添加到PATH这是最关键的一步。它允许你在任何命令行窗口如CMD、PowerShell中直接使用pdflatex,xelatex等命令。很多高级工具和脚本依赖于此。安装后操作安装程序可能会问你是否在安装后立即更新。由于安装包本身已经是最新发布版首次安装可以跳过此步等安装完成后再通过其自带的包管理器tlmgr进行更新。4. 安装实操全流程记录以Windows为例下面我以Windows平台为例展示一个完整的、带有详细注释的安装过程。macOS和Linux用户虽然界面不同但核心逻辑是相通的。4.1 下载与启动首先访问TeX Live官网的下载页面。由于官网镜像众多选择一个地理位置离你较近的镜像站如国内的清华、阿里云镜像下载install-tl-windows.exe。下载完成后右键点击该文件选择“以管理员身份运行”。这是为了避免在安装过程中因权限不足导致写入系统目录失败。4.2 图形界面安装步骤分解安装程序启动后你会看到一个命令行窗口闪过然后出现图形界面。欢迎界面直接点击“下一步”。许可协议阅读并点击“我接受”下一步。安装设置这是核心页面。安装目录如前所述除非C盘空间告急否则保持默认C:\texlive\2024。安装集合选择“完整安装Full installation”。下方的“自定义”选项会展开一个巨大的树状列表列出了所有宏包集合如“基础”、“数学”、“字体”、“人文”等。除非你非常清楚自己在做什么否则不要动这里。创建快捷方式确保“创建开始菜单条目”和“将TeX Live加入到系统PATH中”都被勾选。对于“将TeX Live加入到系统PATH中”有一个下拉选项选择“对所有用户”如果你有管理员权限或“仅对当前用户”。纸张设置默认是A4纸这符合中国及大多数国家的标准无需修改。安装前预览安装程序会展示你的选择摘要。仔细核对安装路径和“添加到PATH”的选项。确认无误后点击“安装”。安装过程接下来就是漫长的文件复制和解压过程。完整安装需要下载并解压约8GB的数据根据你的网速和硬盘速度可能需要30分钟到2小时。期间你可以去做别的事情但最好保持电脑通电和网络连接稳定。安装完成安装结束后点击“关闭”。非常重要的一步关闭所有命令行窗口和可能的编辑器然后重启你的电脑。这是为了让系统PATH环境变量的更改生效。4.3 验证安装是否成功重启后我们需要验证安装是否真正成功特别是PATH是否配置正确。打开“命令提示符”CMD或 PowerShell。输入命令tex --version并回车。如果安装成功且PATH配置正确你会看到类似如下的输出显示了TeX Live的版本信息和版权声明TeX 3.141592653 (TeX Live 2024) kpathsea version 6.3.5 Copyright 2024 D.E. Knuth. ...再测试一下LaTeX引擎输入pdflatex --version和xelatex --version。它们也应该能正确输出版本信息。如果这些命令返回“不是内部或外部命令”的错误说明PATH没有正确添加。你需要手动检查环境变量在系统设置中搜索“环境变量”编辑“Path”添加一条新记录值为你的TeX Live安装目录下的bin\win32或bin\win64例如C:\texlive\2024\bin\win64。保存后重新打开命令提示符再测试。5. 核心工具链配置与初步使用安装好TeX Live只是拥有了引擎就像有了汽车发动机你还需要方向盘和仪表盘编辑器来驾驶。同时了解核心编译命令是驾驭LaTeX的基础。5.1 编译引擎的选择pdflatex, xelatex, lualatexTeX Live自带多个编译引擎最常用的是这三个pdflatex最传统、最稳定、编译速度最快的引擎。它直接生成PDF但不支持系统字体只能使用TeX自带的字体或安装的字体包对中文等非拉丁文字支持需要额外配置如使用CJK宏包。适合纯英文、无需复杂字体的文档。xelatex目前中文用户的绝对主力。它原生支持Unicode和操作系统安装的TrueType/OpenType字体。这意味着你可以直接在文档中使用“宋体”、“微软雅黑”等系统字体对中文、日文等东亚文字支持完美。编译速度比pdflatex稍慢但完全可接受。lualatex基于Lua脚本引擎是最现代、功能最强大的引擎。它同样支持系统字体并且由于Lua的扩展性可以实现更复杂的排版功能如动态内容处理。编译速度相对最慢是未来发展的方向。实操心得对于新手尤其是中文用户我建议从xelatex开始。它平衡了功能、易用性和兼容性。你可以在文档开头通过\documentclass命令后使用\usepackage{fontspec}来轻松指定中文字体。5.2 编辑器的选择与配置你可以用记事本写LaTeX代码但那无疑是自讨苦吃。一个好的编辑器能提供语法高亮、命令补全、一键编译、错误跳转、实时预览等功能。TeXstudio免费、开源、功能全面对新手非常友好。安装后它通常能自动检测到TeX Live。如果没有你需要手动配置选项-设置TeXstudio-命令检查TeX路径下的pdflatex,xelatex等命令是否指向了TeX Live的bin目录。Visual Studio Code (VSCode) LaTeX Workshop插件这是目前很多开发者和进阶用户的首选。VSCode本身轻量强大LaTeX Workshop插件提供了极其专业的LaTeX支持。安装插件后需要配置settings.json。一个关键配置是告诉插件使用xelatexlatex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ], latex-workshop.latex.recipes: [ { name: xelatex - bibtex - xelatex*2, tools: [xelatex, bibtex, xelatex, xelatex] } ]这个“配方”recipe定义了一个完整的编译流程先用xelatex编译生成aux文件然后用bibtex处理参考文献再连续两次用xelatex确保引用和目录正确。Overleaf一个在线的LaTeX编辑器。它无需本地安装任何东西打开浏览器就能写并且内置了完整的TeX Live环境。非常适合协作、轻量使用或者在多台电脑间同步。但对于大型项目、需要自定义宏包或离线工作本地环境仍是必须。5.3 你的第一个LaTeX文档让我们用最经典的“Hello, World!”来测试整个环境。打开你的编辑器以TeXstudio为例新建一个文件输入以下内容% 指定文档类为article使用UTF-8编码 \documentclass[UTF8]{article} % 引入必要的宏包fontspec用于支持系统字体xeCJK用于中文字体处理 \usepackage{fontspec} \usepackage{xeCJK} % 设置中文字体请确保你的系统有这些字体 \setCJKmainfont{SimSun} % 宋体 \setCJKsansfont{Microsoft YaHei} % 微软雅黑 \setCJKmonofont{SimHei} % 黑体 % 文档开始 \begin{document} \title{我的第一个\LaTeX 文档} \author{你的名字} \date{\today} \maketitle \section{引言} 你好世界这是一个简单的\LaTeX 文档示例。 \section{数学公式} 行内公式勾股定理 $a^2 b^2 c^2$。 行间公式 \[ E mc^2 \] \section{列表} \begin{itemize} \item 无序列表项一 \item 无序列表项二 \end{itemize} \begin{enumerate} \item 有序列表项一 \item 有序列表项二 \end{enumerate} \end{document}保存文件命名为hello.tex。在TeXstudio的工具栏上将编译引擎切换到XeLaTeX通常在工具栏中间有一个下拉菜单然后点击绿色的“编译并查看”箭头。如果一切顺利右侧预览窗口将显示一个排版精美的PDF包含了标题、章节、公式和列表。6. 包管理器tlmgr的使用指南TeX Live的强大之处在于其庞大的宏包生态。虽然完整安装已经包含了绝大多数宏包但宏包会更新偶尔你也需要安装一个极其冷门的、未被包含在默认集合中的宏包。这时就需要用到TeX Live自带的包管理器——tlmgrTeX Live Manager。6.1 基本操作更新、搜索、安装tlmgr是一个命令行工具。请以管理员身份Windows或使用sudoLinux/macOS打开命令行。更新tlmgr自身和宏包数据库在安装任何新东西之前先更新本地数据库是个好习惯。tlmgr update --self tlmgr update --all第一条命令更新tlmgr自己第二条命令更新所有已安装的宏包到最新版本。搜索宏包如果你不知道某个功能对应哪个宏包可以搜索。tlmgr search --global --file /tikz这个命令会搜索所有包含“tikz”字符串的宏包。--global表示搜索所有集合--file表示按文件名搜索。安装宏包假设你需要安装minted宏包用于高亮显示代码。tlmgr install minted安装后你就可以在文档中使用\usepackage{minted}了。注意minted宏包依赖Python的Pygments库你还需要用pip install Pygments安装它这就是LaTeX宏包有时会有的外部依赖。卸载宏包谨慎使用tlmgr remove minted6.2 镜像源切换加速下载默认的官方镜像可能在国外下载更新速度很慢。我们可以将其切换到国内镜像源如清华TUNA镜像。Windows打开tlmgr-guiTeX Live Manager的图形界面可以在开始菜单找到在操作菜单下选择载入其他网络仓库输入镜像地址https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet然后点击“确定”。之后的操作就会从这个镜像进行了。命令行适用于所有平台tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet执行此命令后再运行tlmgr update --self等命令就会使用清华镜像。注意事项切换镜像源后如果遇到“仓库不匹配”的错误可能需要先使用tlmgr update --self --repository https://mirror.ctan.org/systems/texlive/tlnet从官方源更新tlmgr自身然后再切换回国内镜像。这是一个经典的“鸡生蛋”问题。7. 常见问题与排查技巧实录即使按照步骤安装在实际使用中仍会遇到各种问题。下面是我总结的一些高频问题及其解决方案。7.1 编译错误排查流程当点击编译后出现错误不要慌张。遵循以下排查流程看错误信息编译器如xelatex会在输出窗口或命令行给出错误信息通常以!开头。错误信息的第一行往往指出了错误类型和出错的宏包或命令。定位错误行错误信息里会包含文件名和行号例如l.25表示第25行。编辑器如TeXstudio, VSCode通常会高亮错误行或提供一键跳转。分析常见错误File ended while scanning use of \xxx通常是因为缺少闭合的括号}、花括号}或环境结束语句\end{xxx}。检查错误行附近的结构是否完整。Undefined control sequence.你使用了一个未定义的命令。最常见的原因是拼写错误如\usepackge应为\usepackage或者没有引入所需的宏包。**LaTeX Error: Filexxx.sty not found.**缺少名为xxx的宏包。你需要用tlmgr install xxx安装它。**Fontxxx not found.**使用xelatex时系统找不到你指定的字体。检查字体名是否拼写正确区分大小写或者该字体是否确实安装在你的系统中。可以用fc-list命令Linux/macOS或在系统字体设置里查看可用字体名。使用最小工作示例MWE这是调试LaTeX问题的黄金法则。当你遇到一个复杂错误时新建一个最简单的.tex文件只包含能复现错误的最少代码。这能排除文档其他部分的干扰也方便你向他人求助时提供清晰的代码。7.2 特定问题解决方案速查表问题现象可能原因解决方案编译后PDF中中文显示为空白或乱码1. 未使用xelatex或lualatex引擎。2. 未正确引入fontspec和xeCJK宏包。3. 指定的中文字体不存在或名称错误。1. 确保编译器是xelatex。2. 在导言区添加\usepackage{fontspec}和\usepackage{xeCJK}。3. 使用\setCJKmainfont{字体名}指定一个系统中确实存在的字体如SimSun。参考文献引用显示为问号[?]文献数据库.bib文件未被处理或编译流程不完整。完整的编译流程应为xelatex-bibtex/biber-xelatex-xelatex。在编辑器中设置正确的编译“配方”recipe。插入的图片找不到1. 图片文件路径错误或文件名错误包括扩展名。2. 图片文件格式不支持LaTeX原生支持.pdf,.jpg,.png等但需要graphicx宏包。3. 使用了相对路径但工作目录不对。1. 检查\includegraphics命令中的路径和文件名。2. 确保导言区有\usepackage{graphicx}。3. 将图片文件放在与.tex文件相同的目录下或使用绝对路径。对于复杂项目建议使用\graphicspath{{figures/}}命令设置图片搜索路径。数学公式渲染异常或报错1. 数学环境使用错误如$...$写在了段落外。2. 使用了未引入的数学符号宏包中的命令。1. 确保行内公式用$...$包裹行间公式用\[...\]或equation环境。2. 如需特殊符号如\mathbb用于黑板粗体引入amsfonts或amssymb宏包。编译速度异常缓慢1. 文档非常长且复杂。2. 使用了minted等需要调用外部程序的宏包。3. 杀毒软件或实时保护干扰。1. 使用\includeonly{}命令只编译当前正在撰写的章节。2. 对于minted可以先用-shell-escape参数编译一次生成缓存后续编译会快很多。3. 将LaTeX编译器的临时目录如_minted*添加到杀毒软件的白名单。7.3 关于“下载PDF乱码/公式乱码”的深度解析网络热词中提到了“latex 下载pdf乱码”和“latex 下载pdf 公式乱码”这是一个非常典型的问题根源通常不在LaTeX本身而在查看器或生成过程。字体嵌入问题如果你使用了系统字体通过fontspec而编译后的PDF没有完全嵌入这些字体那么在其他没有安装该字体的电脑上打开时就会用其他字体替代导致乱码或版式错乱。解决方案确保编译引擎如xelatex正确嵌入了字体。通常xelatex默认会嵌入所用字体。你可以用PDF阅读器如Adobe Acrobat的“文件”-“属性”-“字体”菜单检查PDF中使用的字体是否显示为“已嵌入子集”。PDF阅读器不兼容有些轻量级的PDF阅读器特别是某些浏览器内置的预览插件对复杂字体或特殊编码的PDF支持不佳。解决方案换用专业的PDF阅读器打开如Adobe Acrobat Reader、Foxit Reader或macOS自带的“预览”应用。这是排查此类问题的第一步。编译引擎选择错误用pdflatex处理包含中文字符的文档如果不配合特殊的宏包如CJK进行复杂配置必然产生乱码。解决方案对中文文档始终使用xelatex或lualatex。源代码文件编码问题你的.tex文件本身保存的编码不是UTF-8而编辑器或编译器却以UTF-8去解读导致乱码。解决方案确保你的编辑器如VSCode、TeXstudio将文件编码设置为UTF-8 without BOM。在文档类选项中声明[UTF8]如\documentclass[UTF8]{article}也是一个好习惯。我个人在协作中遇到对方打开我的PDF显示乱码时首先会问他用的什么阅读器然后让他用Acrobat Reader再试一次。十有八九问题就解决了。如果还有问题我会检查我本地的编译日志确认字体是否成功嵌入。
