1. 项目概述为什么在2024年我依然推荐你从LaTeX开始如果你经常需要和公式、论文、书籍排版打交道或者你受够了Word在调整格式时那种“牵一发而动全身”的无力感那么LaTeX这个名字你应该不陌生。它不是一个软件而是一个基于TeX的排版系统简单来说它让你用写代码的方式去“描述”你的文档结构然后由系统自动生成精美、专业的排版结果。听起来有点技术门槛别担心这正是它强大和稳定的根源。我接触LaTeX超过十年从本科毕业论文到现在的技术文档它始终是我的首选。很多人被其“编程”式的入门方式劝退但我想说一旦你跨过最初的学习曲线那种对文档的绝对掌控感和解放双手的自动化排版会让你再也回不去手动拖拽调整的时代。今天我们不谈高深的宏包定制就从最根本的开始彻底搞懂LaTeX是什么以及如何为你自己的电脑搭建一个稳定、高效的LaTeX工作环境——核心就是安装TeX Live发行版。网络上教程很多但要么过于简略跳过了关键细节要么版本老旧已经不适应现在的系统。我会结合最新的实践带你走一遍完整的安装、验证和基础使用的流程并分享那些只有踩过坑才知道的注意事项。无论你是科研工作者、学生还是对高质量排版有追求的创作者这篇文章都能帮你打下最坚实的第一步。2. LaTeX核心价值与TeX Live发行版解析2.1 LaTeX不仅仅是“公式编辑器”很多人对LaTeX的第一印象是“打数学公式很厉害”。这没错但它严重低估了LaTeX的能力。LaTeX的核心哲学是“内容与格式分离”。在Word里你边写内容边设置字体、间距、标题样式内容和格式高度耦合。而在LaTeX中你用一个纯文本文件.tex写下内容并用简单的命令如\section{引言}标记结构所有的排版规则如一级标题用什么字体、多大字号、上下间距多少都定义在一个叫做“文档类”和“样式文件”的地方。编译时LaTeX引擎会读取你的内容并严格按照预设的规则进行排版。这样做带来的好处是颠覆性的极致的一致性整篇文档的标题、图表、公式、参考文献格式完全统一绝不会出现某个标题字体突然变了的情况。复杂的自动化目录、图表索引、交叉引用、参考文献列表全部自动生成和更新。你只需要用\label和\ref标记引用时写\ref{eq:1}即可编号完全自动管理。专业级的排版质量TeX引擎的排版算法特别是断行和断页算法是经过数学优化的其生成的PDF在字符间距、单词间距、段落美观度上通常优于普通办公软件。稳定性与版本控制友好源文件是纯文本可以用Git等工具进行版本管理轻松对比不同版本间的修改完全避免了二进制文件如.docx的兼容性和损坏问题。所以LaTeX更适合处理结构复杂、公式繁多、引用频繁的长文档比如学位论文、学术书籍、技术报告等。2.2 TeX Live为什么它是LaTeX环境的“全家桶”LaTeX本身只是一套宏命令和格式文件它需要一个底层的TeX引擎如pdfTeX, XeTeX, LuaTeX来执行编译还需要成千上万的宏包字体、绘图、特殊功能来扩展功能。手动管理这些组件是噩梦。因此出现了“发行版”的概念它把引擎、宏包、字体、文档等所有必需品打包在一起提供统一的管理工具。TeX Live就是目前跨平台Windows, Linux, macOS最主流、最完整的发行版。它的优势非常明显完整性包含了绝大多数你会用到的宏包安装后基本无需再联网查找。一致性在不同操作系统上提供几乎相同的文件和工具减少了跨平台工作的麻烦。强大的包管理器内置的tlmgr(TeX Live Manager) 可以方便地更新、安装、卸载宏包。维护活跃每年发布一个新版本持续更新和修复。与之相对的在Windows上你可能还听过MiKTeX。MiKTeX的特点是“按需安装”初始安装包小在编译时如果缺少宏包会提示并自动下载安装。这对于硬盘空间紧张的用户很友好。但我个人更推荐TeX Live原因在于其稳定性和可预测性。MiKTeX的自动安装有时会受网络环境影响在关键时刻比如论文截止前可能掉链子。而TeX Live的一次性完整安装确保了整个工作环境是自包含、离线可用的这对于需要绝对可靠性的工作流至关重要。除非你的硬盘空间真的极其有限否则TeX Live是更省心、更专业的选择。3. TeX Live安装全流程详解与避坑指南3.1 安装前的关键决策网络安装与ISO镜像安装TeX Live提供了两种安装方式网络安装器和完整ISO镜像。网络安装器一个很小的引导程序约几十MB运行后会从网络仓库下载所需的所有包。这需要稳定且快速的网络连接总下载量约4-5GB。完整ISO镜像一个约4GB的单一镜像文件包含所有安装包。下载后可以离线安装也可以用于制作U盘安装盘。我的强烈建议是直接下载完整ISO镜像进行安装。理由如下网络稳定性国内访问国外的TeX Live仓库速度可能不稳定网络安装中途失败的概率不低重试起来很麻烦。安装速度从本地硬盘读取ISO文件安装速度远快于从网络下载。可重复性与备份ISO文件可以保存下来以后给其他电脑安装、或者重装系统时都非常方便无需重新下载。安装过程可控你可以选择安装路径、安装的集合Scheme而网络安装器有时选项不够直观。操作步骤访问TeX Live官方主页可通过搜索“TeX Live”找到找到下载页面。选择“download”下的“ISO image”进行下载。通常文件名为texlive2024.iso年份随版本变化。下载完成后你需要“挂载”这个ISO文件。Windows 10/11直接双击ISO文件系统会将其加载为一个虚拟光驱如G:盘。macOS双击ISO文件它会自动挂载到/Volumes目录下。Linux可以使用mount命令或使用图形化文件管理器右键挂载。3.2 执行安装参数选择与注意事项挂载ISO后你会看到里面有一个install-tl-windows.bat(Windows) 或install-tl脚本Unix/Linux/macOS。请务必以管理员/root权限运行它因为安装过程会向系统目录写入文件。启动安装程序后你会看到一个图形界面GUI或命令行界面。GUI界面更友好我们以此为例。有几个关键设置需要你注意安装目录Installation directory默认路径通常是C:\texlive\2024Windows或/usr/local/texlive/2024Unix-like。我建议不要安装在C盘根目录或系统Program Files目录下特别是Windows系统这些路径的权限管理严格可能导致后续包管理tlmgr更新失败。可以修改为D:\TeXLive\2024或/home/yourname/texlive/2024这样的自定义路径。路径中不要包含中文或空格避免潜在的兼容性问题。安装方案Installation schemeScheme: full (推荐)安装所有内容约4GB。这是最省事的选择一劳永逸避免日后编译时缺少宏包。Scheme: medium安装大部分常用内容约1GB。适合有经验的用户知道自己需要什么。Scheme: small最小安装约400MB。仅限高手或极端空间受限情况。对于绝大多数用户特别是新手请直接选择“full”。硬盘空间在今天已经不是瓶颈为了省1-2GB空间而带来未来可能出现的“宏包缺失”报错得不偿失。创建菜单快捷方式和文件关联Options在“Options”里确保勾选了“Create shortcuts in the Start Menu”和“File associations”将.tex文件关联到TeX编辑器但这一步关联可能不完美我们通常用专门的编辑器如VS Code或TeXstudio。特别重要找到“Adjust the system PATH”选项。在Windows下建议选择“Add TeX Live to the system PATH for all users”。这会将TeX Live的二进制文件目录如bin/win64添加到系统的环境变量PATH中。这是至关重要的一步它使得你可以在任何命令行窗口如CMD、PowerShell或第三方编辑器如VS Code中直接调用pdflatex,xelatex等命令。如果忘记这一步后续配置编辑器时会非常麻烦。设置完成后点击“Install”开始安装。根据你的硬盘速度安装过程可能需要20分钟到1小时。安装期间请保持电脑通电不要中断。注意安装完成后务必重启一次电脑。这是为了让系统环境变量PATH的更改生效。很多人在安装后直接测试失败原因就是没重启。4. 验证安装与基础环境配置4.1 验证安装是否成功安装并重启后我们需要验证TeX Live是否已正确集成到系统中。打开命令行Windows: 按WinR输入cmd或powershell回车。macOS/Linux: 打开终端Terminal。检查命令和版本 在命令行中依次输入以下命令并回车tex --version latex --version xelatex --version如果每条命令都能返回对应的版本信息如TeX 3.14159265...并且没有“不是内部或外部命令”的错误那么恭喜你TeX Live的核心引擎安装成功了。检查包管理器 输入tlmgr --version应该能看到TeX Live管理器的版本信息。这证明tlmgr命令也可用。4.2 更新TeX Live包管理器可选但推荐虽然我们安装的是完整版但TeX Live的包管理器tlmgr本身可能会有后续的更新。为了确保管理功能是最新的建议先更新tlmgr本身。由于我们使用ISO安装默认仓库指向本地路径需要先将其切换到网络仓库。在命令行中执行可能需要管理员权限tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet这里我将仓库地址换成了国内的清华镜像速度会快很多。然后更新tlmgr update --self --all这个命令会先更新tlmgr自身 (--self)然后更新所有已安装的宏包 (--all)。这个过程需要联网时间较长你可以选择在空闲时进行。对于新手如果当前环境工作正常此步骤可以暂缓执行。5. 选择你的LaTeX编辑器TeXstudio vs. VS Code引擎安装好了你还需要一个编辑器来编写.tex源文件。纯文本编辑器如记事本可以写但效率极低。专业的LaTeX编辑器提供语法高亮、命令补全、一键编译、正向/反向搜索在PDF和源码间跳转等功能。5.1 TeXstudio开箱即用的集成环境TeXstudio是一个专为LaTeX设计的、功能高度集成的IDE。它的最大优点是配置简单安装后几乎无需任何设置就能开始工作。优点一体化编辑器、PDF查看器、编译按钮、日志窗口全部集成在一个界面内。智能补全对LaTeX命令、宏包、引用\ref、文献\cite的补全非常强大。内置PDF查看器支持与源码的同步滚动和点击跳转正向/反向搜索。丰富的向导提供插入表格、图片、公式的图形化向导对新手友好。安装与配置从其官网下载安装包安装过程非常简单。安装后首次运行它通常能自动检测到系统中已安装的TeX Live路径。你可以在Options - Configure TeXstudio - Commands中检查Pdflatex、Xelatex等命令的路径是否已正确指向你的TeX Live安装目录下的bin文件夹。适合人群LaTeX初学者或者希望专注于写作、不想在工具配置上花费太多精力的用户。TeXstudio让你能快速上手把精力集中在内容上。5.2 VS Code LaTeX Workshop插件高度可定制的现代选择Visual Studio Code (VS Code)是一个通用的代码编辑器通过安装LaTeX Workshop插件可以变身为一款极其强大的LaTeX编辑器。它的优势在于高度可定制性和与现代开发工作流的无缝集成。优点性能与体验VS Code本身速度快界面现代多标签管理方便。强大的扩展性除了LaTeX你还可以用同一个编辑器写Python、Markdown、做笔记等。深度定制LaTeX Workshop插件提供了极其详细的配置项你可以完全定义自己的编译链latexmk, arara、快捷键、预览方式等。与Git完美集成VS Code内置了强大的Git图形化界面管理你的LaTeX项目版本历史非常方便。配置步骤安装VS Code。在扩展市场搜索并安装 “LaTeX Workshop”。基本配置通常插件会自动配置但了解原理很重要打开一个.tex文件VS Code会识别并激活LaTeX Workshop。检查编译命令按下CtrlShiftP输入 “LaTeX Workshop: Recipes”查看默认的编译配方recipe。通常它会使用latexmk这是一个能自动处理多次编译生成目录、引用、参考文献的智能工具。关键点由于我们已将TeX Live加入系统PATHVS Code和LaTeX Workshop插件通常能自动找到pdflatex,xelatex,latexmk等命令无需手动配置路径。如果遇到编译失败提示找不到命令才需要去插件设置里手动指定tex相关工具的路径。适合人群有一定技术背景喜欢折腾和定制或者已经在使用VS Code进行其他编程工作的用户。它提供了更大的灵活性和控制力。我的建议如果你是纯新手从TeXstudio开始阻力最小。如果你本身就是程序员或技术爱好者直接上VS Code LaTeX Workshop长远来看更高效。6. 你的第一个LaTeX文档从编译到排错环境搭建好了编辑器也选好了让我们来创建一个最简单的文档测试整个工作流。6.1 编写基础文档在你的工作目录下新建一个文件命名为hello.tex。用你选择的编辑器打开它输入以下内容\documentclass{article} % 文档类文章 \usepackage[UTF8]{ctex} % 引入ctex宏包支持中文 \title{我的第一个\LaTeX 文档} \author{你的名字} \date{\today} \begin{document} \maketitle % 生成标题 \section{引言} 你好世界这是我的第一个\LaTeX{}文档。 \section{数学公式} 这是一个行内公式$E mc^2$。 这是一个行间公式 \[ \sum_{i1}^{n} i \frac{n(n1)}{2} \] \section{列表} \begin{itemize} \item 这是一个无序列表项。 \item 另一个列表项。 \end{itemize} \begin{enumerate} \item 这是一个有序列表项。 \item 第二个有序项。 \end{enumerate} \end{document}代码解析\documentclass{article}指定文档类型为“文章”这是最基础的文档类。\usepackage[UTF8]{ctex}引入ctex宏包它是处理中文排版的“瑞士军刀”。[UTF8]选项指定源文件编码为UTF-8这是现代编辑器的默认编码必须保持统一否则中文会乱码。\title,\author,\date定义文档的元信息。\begin{document} ... \end{document}文档内容的开始和结束标记所有正文内容都写在这里面。\maketitle根据上面定义的元信息生成标题。\section{}生成一级章节标题。$...$和\[ ... \]分别是行内数学公式和行间数学公式的环境。itemize和enumerate环境分别生成无序列表和有序列表。6.2 编译与生成PDF在TeXstudio中保存文件。点击工具栏上的绿色箭头编译并查看或按F5。TeXstudio默认会使用pdflatex或xelatex进行编译取决于设置对于中文文档xelatex是更好的选择它原生支持Unicode和系统字体。编译成功后右侧的PDF预览窗口会自动刷新显示结果。在VS Code中保存文件。通常LaTeX Workshop插件设置为保存文件时自动编译。你也可以按CtrlAltB默认快捷键手动触发编译。编译成功后会在同目录下生成hello.pdf文件。VS Code内部也会打开一个标签页预览PDF需要安装PDF预览扩展如 “PDF Viewer”。编译命令的选择pdflatex最常用的引擎直接生成PDF。但对于复杂的中文文档或需要特殊字体时可能力不从心。xelatex处理中文文档的推荐引擎。它直接使用系统安装的TrueType/OpenType字体对中文支持非常好。我们上面使用了ctex宏包它内部会智能调用xelatex。lualatex另一个现代引擎同样支持Unicode和系统字体并且内嵌了Lua脚本引擎扩展性更强。对于我们的测试文档无论用哪个引擎配合ctex宏包都应该能成功编译出包含中文的PDF。6.3 解读编译日志与常见错误排查第一次编译很可能不会一帆风顺。编译窗口或终端里会输出大量日志信息。不要被吓到关键信息通常只在最后几行。1. 成功编译的迹象 日志最后会显示类似Output written on hello.pdf (1 page).和Transcript written on hello.log.并且整个过程没有以Error或!开头的致命错误信息。2. 常见错误及解决方法错误! LaTeX Error: File ‘ctex.sty’ not found.原因TeX Live安装不完整或者编译引擎没有找到ctex宏包。但如果你按照本文安装了“full” scheme这不应该发生。排查在命令行输入kpsewhich ctex.sty。这个命令会返回ctex.sty文件在系统中的完整路径。如果返回为空说明确实没找到可能是安装损坏或环境变量问题。检查环境变量确保TeX Live的bin目录如D:\TeXLive\2024\bin\win64已正确添加到系统PATH并且已重启电脑。如果路径正确但依然找不到可以尝试在命令行用tlmgr install ctex手动安装但完整安装理应已包含。错误中文显示为乱码或方块原因源文件编码、编译器、宏包设置不匹配。解决确保源文件 (.tex) 保存为 UTF-8 编码。这是现代编辑器的默认设置但务必检查。在VS Code或TeXstudio底部状态栏可以看到编码格式。确保使用xelatex或lualatex引擎编译。pdflatex对UTF-8和非ASCII字符如中文处理需要额外配置而xelatex是原生支持。在TeXstudio的“选项-设置TeXstudio-构建-默认编译器”中改为“XeLaTeX”。在VS Code的LaTeX Workshop设置中可以修改编译配方recipe为使用xelatex。确保引入了正确的宏包使用\usepackage[UTF8]{ctex}。错误! Undefined control sequence.原因输入了不存在的LaTeX命令。比如把\documentclass拼成了\documentclass。解决仔细检查错误信息指向的行号附近的命令拼写。LaTeX命令是大小写敏感的。警告Citation ‘xxx’ on page y undefined或There were undefined references.原因文档中使用了\cite命令引用了参考文献但还没有运行生成参考文献列表的程序如BibTeX或Biber。解决这是一个正常流程。对于包含参考文献的文档完整的编译流程通常是xelatex-biber(或bibtex) -xelatex-xelatex。需要编译2-3次才能正确生成引用和参考文献列表。高级工具如latexmk会自动处理这个流程。3. 使用latexmk自动化编译流程 为了避免手动处理复杂的编译顺序强烈推荐使用latexmk。它是一个Perl脚本能自动判断需要运行多少次编译、调用哪个引擎和参考文献工具。在命令行进入你的.tex文件所在目录运行latexmk -xelatex -synctex1 -interactionnonstopmode -file-line-error hello.tex。在TeXstudio中可以将默认编译器设置为“Latexmk”在设置中配置命令。在VS Code的LaTeX Workshop中默认的编译配方通常就是基于latexmk的。配置好latexmk后你只需要点一次编译所有事情处理交叉引用、参考文献、目录都会自动完成极大提升了效率。7. 进阶第一步管理宏包、字体与项目结构7.1 使用tlmgr管理宏包虽然完整安装包含了绝大多数宏包但偶尔你还是会遇到需要安装新宏包的情况或者需要更新现有宏包。搜索宏包tlmgr search --global --file 关键词。例如想找与绘图相关的包可以搜tlmgr search --global --file tikz。安装宏包tlmgr install 宏包名。例如安装一个很棒的绘图包tlmgr install pgfplots。需要管理员权限Windows下用管理员命令行Linux/macOS下加sudo。更新所有宏包tlmgr update --all。建议定期如每季度运行一次以获取bug修复和新功能。列出已安装宏包tlmgr list --only-installed。重要提示更新或安装宏包后有时需要重建TeX的文件名数据库以便系统能立即找到新文件。命令是texhash或mktexlsr两者等效。在命令行运行一下即可。7.2 中文字体配置使用ctex宏包ctex宏包极大地简化了中文排版。在文档开头\usepackage[UTF8]{ctex}后默认会使用一套不错的中易字体SimSun, SimHei等。如果你想使用其他系统字体比如“思源宋体”、“霞鹜文楷”也很简单。\documentclass{article} \usepackage[UTF8]{ctex} \setCJKmainfont{Source Han Serif SC} % 设置中文主字体为思源宋体简体 \setCJKsansfont{Source Han Sans SC} % 设置中文无衬线字体为思源黑体简体 \setCJKmonofont{SimHei} % 设置中文等宽字体 \begin{document} 这里是正文将使用思源宋体显示。 \textsf{这里使用无衬线字体思源黑体。} \texttt{这里使用等宽字体。} \end{document}你需要确保系统中已安装这些字体。ctex宏包会通过系统的字体配置来查找它们。在Windows和macOS上安装的字体通常可以直接使用。在Linux上可能需要额外的字体配置步骤。7.3 组织你的LaTeX项目当文档变得复杂如毕业论文一个好的项目结构至关重要。我的论文/ ├── main.tex # 主文档只包含文档类、宏包引入和章节引用 ├── chapters/ # 存放各章节 │ ├── introduction.tex │ ├── related_work.tex │ └── conclusion.tex ├── figures/ # 存放所有图片 │ ├── fig1.pdf │ └── diagram.tikz ├── data/ # 存放数据文件如果需要 ├── references.bib # BibTeX参考文献数据库 └── Makefile (或 latexmkrc) # 自动化编译脚本在main.tex中你可以这样组织\documentclass{report} \usepackage[UTF8]{ctex} % ... 其他宏包 ... \begin{document} \include{chapters/introduction} \include{chapters/related_work} % ... 其他章节 ... \bibliographystyle{plain} \bibliography{references} % 引用references.bib文件 \end{document}使用\include{文件}命令可以插入子文件便于管理。使用\input{文件}命令也可以两者的区别在于\include会单独编译子文件并缓存适合大型文档分章节独立编译而\input是直接插入内容。最后在项目根目录创建一个名为.latexmkrcUnix-like系统或latexmkrcWindows的文件可以自定义latexmk的行为例如默认使用xelatex和biber$pdf_mode 1; $pdflatex xelatex -synctex1 -interactionnonstopmode -file-line-error; $bibtex_use 2; # 使用biber $biber biber --debug;这样在项目目录下只需运行latexmk命令就会按照你的配置进行自动化编译了。