LaTeX 新手启航从零到“Hello World”的完整避坑手册如果你是一名刚刚接触学术写作、技术文档排版或者被导师要求用 LaTeX 提交论文的新手那么恭喜你打开了一扇通往专业排版世界的大门同时也可能即将踏入一个充满“坑”的领域。网络上流传的教程很多但往往语焉不详或者版本老旧导致新手在第一步安装配置上就耗费数小时甚至因为某个小细节的疏忽而前功尽弃。这篇文章就是为你这样的小白准备的。我们将不依赖任何过时的套件直接从官方最纯净的发行版开始手把手带你走过从下载、安装、验证到写出第一个文档的全过程。我会把那些教程里常常一笔带过却最容易让你卡住的“坑”——比如文件校验、权限问题、环境变量、编辑器配置——掰开揉碎了讲清楚。我们的目标很简单让你用最稳妥、最清晰的方式在自己的电脑上成功运行起第一行 LaTeX 代码看到那个经典的“Hello, World!”。1. 安装前的准备选择与下载的正确姿势在开始安装任何软件之前明确“用什么”和“从哪里来”至关重要。对于 LaTeX 而言这意味着选择一个活跃维护的发行版和一个可靠的下载源。过去很多中文教程会推荐 CTeX 套装因为它集成了中文环境开箱即用。但必须指出CTeX 的核心组件已经多年未更新其内置的 MikTeX 版本老旧可能会与一些最新的宏包或功能产生兼容性问题。因此对于追求稳定和长期可维护性的用户我们强烈推荐使用TeX Live这是由 TUG (TeX Users Group) 维护的跨平台发行版更新积极包罗万象。1.1 获取 TeX Live 安装镜像TeX Live 的官方下载方式是通过网络安装但对于国内用户网络状况可能成为一大障碍。因此从国内的镜像站点下载完整的 ISO 镜像文件是最佳选择。这里以中国科学技术大学开源软件镜像站为例。步骤与关键细节访问镜像站打开浏览器访问 USTC 的 TeX Live 镜像页面。通常页面会列出最新年份的目录例如texlive/2024/。定位 ISO 文件进入对应年份的目录后寻找名为texlive.iso或texlive-YYYY.iso的文件YYYY 代表年份。这个文件大小通常在 4GB 以上它包含了完整的 TeX Live 发行版。执行下载点击该文件进行下载。由于文件较大建议使用具备断点续传功能的下载工具。注意下载完成后一个至关重要的、但绝大多数教程都会忽略的步骤是校验文件完整性。大文件在下载过程中可能发生损坏导致后续安装失败。你可以对比镜像站上提供的texlive.iso.sha512或texlive.iso.md5校验和文件。在命令行Windows 下为 PowerShell 或 CMD中可以使用以下命令进行校验# 以 SHA512 为例先进入 ISO 文件所在目录 certutil -hashfile texlive-2024.iso sha512将命令输出的哈希值与镜像站提供的哈希值进行比对必须完全一致方可进行下一步。1.2 理解安装模式与权限下载好的 ISO 文件是一个光盘镜像。在 Windows 10/11 系统中你可以直接双击挂载它系统会将其视为一个虚拟光驱。安装程序的核心文件是install-tl-windows.bat。这里隐藏着第一个大坑权限。TeX Live 需要向系统目录写入文件、创建环境变量因此必须使用管理员权限运行。错误做法双击install-tl-windows.bat。正确做法在install-tl-windows.bat文件上点击右键选择“以管理员身份运行”。如果权限不足安装过程可能会在中途失败或者安装后无法正常注册导致命令行无法识别 LaTeX 命令。2. 安装过程中的定制化选择以管理员身份运行批处理文件后会弹出一个黑底蓝字的命令行安装界面。这个界面看似复古但功能明确。2.1 修改安装路径安装程序首先会显示默认的安装路径通常是C:\texlive\YYYY。你可以按D键来修改它。我个人的建议是避免路径中包含中文或空格防止潜在的兼容性问题。如果你有专门的软件分区如 D 盘可以将其安装到D:\texlive\2024这样的路径下。2.2 高级配置精简你的安装按A键进入高级配置这里是为你节省大量磁盘空间的关键。默认安装包含了世界上几乎所有语言的字体和宏包但对于大多数中文用户很多语言包是用不到的。进入高级配置后找到与“集合”或“Scheme”相关的选项。TeX Live 提供了几种预定义的安装方案方案名称描述推荐度scheme-full安装一切超过 7GB。除非你是 TeX 系统维护者否则不推荐。★☆☆☆☆scheme-medium安装了大多数常用宏包约 2GB。这是一个比较平衡的选择。★★★★☆scheme-small仅安装基础系统和小部分宏包约 500MB。适合极简用户但可能需要时在线安装宏包。★★★☆☆scheme-basic仅最核心的系统功能非常有限。★☆☆☆☆对于新手我推荐选择scheme-medium。它包含了绝大多数你会用到的宏包避免了日后频繁的在线安装。此外你还可以在“语言集合”中取消勾选除english和chinese(或cjk) 之外的所有语言这又能节省出近 1GB 的空间。配置完成后按R返回主菜单再按I开始安装。接下来就是漫长的等待时间从几十分钟到一小时不等取决于你的电脑性能。请务必保持耐心不要中途关闭窗口或断电。3. 安装后的验证与环境变量配置安装进度条走完出现“欢迎来到 TeX Live 2024!”的提示时说明安装主体已完成。但先别急着关窗口更别急着打开编辑器。我们需要验证安装是否真正成功。3.1 命令行验证第一个测试安装程序最后可能会提示你“将 TeX Live 的bin目录添加到系统的 PATH 中”。它可能会尝试自动添加但在某些系统上可能不生效。因此手动验证是必须的。重新打开一个新的命令行窗口PowerShell 或 CMD。注意必须是新开的因为环境变量的更改需要在新会话中生效。输入以下命令并按回车xelatex --version或者tex --version可能的结果与解决方案情况A成功。命令行返回了详细的版本信息如XeTeX 3.141592653 ...等。恭喜你核心安装成功环境变量也已就绪。你可以直接跳到第4节。情况B失败。系统提示“xelatex不是内部或外部命令也不是可运行的程序...”。这说明系统找不到 TeX Live 的执行文件需要手动配置环境变量。3.2 手动配置环境变量Windows如果验证失败请按照以下步骤操作在 Windows 搜索栏输入“环境变量”选择“编辑系统环境变量”。在弹出的“系统属性”窗口中点击右下角的“环境变量(N)...”。在下方“系统变量”区域找到并选中名为Path的变量点击“编辑”。在弹出的编辑窗口中点击“新建”然后添加 TeX Live 的bin目录路径。这个路径通常是C:\texlive\2024\bin\windows如果你使用了默认安装路径和64位系统。对于 32 位系统目录是bin\win32。如果你修改了安装路径请对应修改。点击“确定”保存所有窗口。再次打开一个新的命令行窗口重复 3.1 节的验证命令。这次应该能成功显示版本信息了。提示环境变量是连接系统与应用程序的桥梁。这一步的失败是新手最高频的“坑”之一。务必确保路径正确且添加到了系统变量的 Path 中并记得重启命令行。4. 编辑器的选择与配置TeXstudio 实战有了强大的 TeX Live 引擎我们还需要一个顺手的“方向盘”——编辑器。TeXstudio 是一个免费、开源、跨平台且功能强大的集成环境对新手非常友好。4.1 安装与基本设置从 TeXstudio 官网下载安装程序过程是标准的“下一步”即可。安装完成后首次运行我们进行几项关键配置让它的行为更符合中文用户习惯。切换为中文界面点击菜单栏Options-Configure TeXstudio。在General选项卡中找到Language下拉菜单选择zh_CN点击“Apply”或“OK”重启 TeXstudio 后界面即为中文。设置默认编译器为 XeLaTeX这是处理中文字体的最佳选择。再次进入选项-设置 TeXstudio切换到“构建”选项卡。在“默认编译器”下拉菜单中选择XeLaTeX。同时建议在“默认文献工具”中选择Biber这是现代 BibLaTeX 的搭档。4.2 创建你的第一个文档并避开经典报错现在让我们点击“文件”-“新建”来创建第一个.tex文件。第一步输入经典代码在编辑区输入以下最基础的 LaTeX 代码\documentclass{article} % 文档类为“文章” \begin{document} % 文档内容开始 Hello, World! % 你的内容 \end{document} % 文档内容结束保存这个文件到一个你准备好的文件夹文件名例如first.tex。第二步构建并查看点击工具栏上方的“构建并查看”按钮通常是一个绿色的单箭头或直接按F5键。预期成功结果TeXstudio 会调用我们刚才设置的 XeLaTeX 编译器在下方“消息”窗口快速闪过一些编译日志然后自动弹出一个 PDF 预览窗口里面清晰地显示着“Hello, World!”。可能遇到的经典报错与解决报错File ‘article.cls’ not found.原因TeX 系统找不到article这个文档类。这通常意味着 TeX Live 根本没有安装成功或者环境变量指向了错误的位置。解决回到本文第3节彻底检查 TeX Live 的安装和环境变量配置。确保在命令行中tex --version能正确运行。报错Cannot find PDF viewer.或 PDF 无法弹出原因TeXstudio 没有找到关联的 PDF 阅读器。解决进入选项-设置 TeXstudio-命令选项卡。检查“PDF 查看器”一栏。可以填写系统默认查看器的路径例如C:\Program Files\Adobe\Acrobat DC\Acrobat\Acrobat.exe路径需根据你电脑的实际安装情况修改。更简单的方法是直接填写xdg-openLinux/macOS或startWindows让系统用默认程序打开。编译无报错但日志窗口出现大量fontspec警告或中文无法显示原因虽然使用了 XeLaTeX但文档没有正确加载字体配置。这是编写中文文档时的下一个关键步骤。解决这超出了“Hello World”的范围但为你指明方向你需要使用ctex宏包或文档类或者通过fontspec宏包手动设置中文字体。一个简单的中文文档开头如下\documentclass[UTF8]{ctexart} % 使用 ctexart 文档类直接支持中文 \begin{document} 你好世界 \end{document}确保使用XeLaTeX进行编译就能正确输出中文。当你成功看到 PDF 输出时你的 LaTeX 基础环境就已经坚实地搭建起来了。这个过程看似步骤繁多但每一步都是在为后续顺畅的写作扫清障碍。记住搭建环境时多花十分钟仔细检查往往能避免后续数小时的折腾。现在引擎和编辑器都已就位你可以开始探索 LaTeX 在数学公式排版、参考文献管理、复杂图表生成方面的强大能力了。