论文写到一半公式编号突然乱掉参考文献怎么都编译不出来Word 里调好的排版换个电脑就面目全非——如果你正在经历这些那大概率是时候认真搭一套 LaTeX 环境了。这篇内容就是写给零基础、被 Word 排版折磨过、想用 LaTeX 写论文或报告但不知道从哪下手的人。我会把 TeX Live 加 TeXstudio 这套组合的安装过程从头到尾讲清楚包括为什么选它们、清华镜像怎么配、中文怎么处理、装完之后怎么验证环境没问题以及我自己踩过的那些坑。整套流程走下来快的话四十分钟能搞定慢的话一个多小时也够了关键是每一步我都告诉你为什么这么做而不是让你照着截图瞎点。1. 为什么是 TeX Live 加 TeXstudio 这套组合1.1 LaTeX 发行版和编辑器的分工关系很多人一开始会搞混一件事LaTeX 到底是什么TeX Live 又是什么TeXstudio 又是干嘛的。我用一个类比你就明白了。LaTeX 是一套排版语言和规则相当于菜谱TeX Live 是这套语言的完整实现和工具集合相当于厨房里所有的锅碗瓢盆和食材TeXstudio 则是你写菜谱用的那本笔记本和笔也就是编辑器。三者缺一不可但职责完全不同。所以安装 LaTeX 环境本质上要装两样东西一个是发行版distribution负责真正把.tex文件编译成 PDF另一个是编辑器editor负责让你舒服地写代码。发行版和编辑器是解耦的你可以用 TeX Live 配 TeXstudio也可以用 TeX Live 配 VS Code甚至用 MiKTeX 配 TeXstudio。理解了这层关系后面遇到我装了编辑器怎么还是编译不了这种问题你就知道是发行版没装好或者路径没配对。那为什么我推荐 TeX Live 而不是 MiKTeX核心原因有三个。第一TeX Live 是跨平台的Windows、macOS、Linux 上命令和行为基本一致你换系统不用重新学一套。第二TeX Live 默认安装完整的宏包集合写论文常用的amsmath、graphicx、booktabs、natbib这些全都有不用像 MiKTeX 那样缺什么临时下载什么避免断网时编译失败的尴尬。第三也是最重要的一点TeX Live 的版本管理更稳定学术期刊和学校模板通常都是基于 TeX Live 测试的兼容性更有保障。1.2 TeXstudio 相比其他编辑器的取舍编辑器这块选择就更多了VS Code、Overleaf 在线版、WinEdt、TeXstudio 各有拥趸。我推荐 TeXstudio 给新手理由很实在它开箱即用不需要你装一堆插件、配一堆 JSON 才能编译它自带 PDF 预览、正向反向搜索点 PDF 跳回源码点源码跳到 PDF 对应位置、语法高亮、命令补全、错误提示这些对新手极其友好。VS Code 当然也能配得很好但你要装 LaTeX Workshop 插件、改settings.json、配编译链对刚入门的人来说心智负担太重容易在配置阶段就劝退。Overleaf 在线版确实省事但免费版有编译时长限制大论文编译慢而且断网就抓瞎隐私性也不如本地。所以我的建议是先用 TeXstudio 把本地环境跑通等你熟悉了 LaTeX 的工作流再考虑要不要迁移到 VS Code 或者用 Overleaf 做协作。这个顺序很重要别一上来就追求最酷的配置先把东西写出来才是正经事。1.3 清华镜像在整个流程里扮演的角色TeX Live 完整版安装包有好几个 GB官方源在国外国内直接下载经常龟速甚至断连。清华镜像TUNA就是把这个安装包和后续的宏包更新同步到国内服务器你从清华源下载速度能快几十倍。这不是可选项而是强烈建议的必选项。除了下载安装包TeX Live 装好之后用tlmgr更新宏包时也要把源指向清华镜像否则每次更新都是煎熬。提示镜像源只是加速下载不改变软件本身的任何功能。你从清华源下载的 TeX Live 和从官方源下载的完全一样不用担心兼容性或安全性问题。2. 安装前的准备工作与版本选择2.1 确认系统环境和磁盘空间TeX Live 完整版装完之后占用大概 7 到 8 GB 磁盘空间安装过程中临时文件还会额外占用一些所以我建议你至少预留 15 GB 的可用空间。如果你硬盘紧张也可以选择基础版 按需安装宏包的方案但我不推荐新手这么做因为写论文时缺宏包报错会让你很抓狂不如一次装全。系统方面Windows 10/11、macOS 10.14 以上、主流 Linux 发行版都没问题。Windows 用户注意安装路径里千万不要有中文和空格比如C:\Program Files\texlive这种带空格的路径虽然现在大多能处理但偶尔还是会有工具链出问题稳妥起见用C:\texlive\2024这种纯英文无空格路径。macOS 用户其实还有个更省事的选择叫 MacTeX它本质就是 TeX Live 的 macOS 打包版安装更傻瓜化但体积也更大本文以通用的 TeX Live 安装为主MacTeX 的操作逻辑基本一致。2.2 下载安装包走清华镜像的正确姿势打开清华镜像的 TeX Live 页面路径通常是https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/。你会看到一堆以年份命名的文件比如texlive2024.iso或者texlive2024-xxx.iso。选最新年份的 ISO 文件下载就行一般 5 GB 左右。下载方式有两种直接浏览器下载或者用下载工具。文件大的话我建议用支持断点续传的工具避免下到一半断了重来。下载完成后Windows 用户直接双击 ISO 文件就能挂载成虚拟光驱或者用解压软件解压出来。macOS 用户双击 ISO 会自动挂载。Linux 用户可以用mount命令挂载。挂载或解压之后你会看到一个install-tl-windows.batWindows或install-tlLinux/macOS的文件这就是安装入口。注意不要在线安装net installer也就是那种下载一个几十 MB 的小启动器然后边下边装的方式。国内网络环境下这种方式极不稳定中途失败的概率很高。老老实实下完整 ISO虽然文件大但一次成功。2.3 安装过程中的关键选项Windows 用户双击install-tl-windows.bat后会弹出一个图形化安装界面。这里有几个关键选择。第一安装方案scheme选full也就是完整安装别选basic或small。第二安装路径确认是纯英文无空格。第三点击Advanced高级按钮找到Customize里的Portable installation选项除非你确实要做便携版否则不要勾选。Linux 和 macOS 用户运行install-tl后是命令行界面输入I回车开始安装同样在开始前可以用D命令修改目录用S命令切换 scheme 到 full。安装过程视机器性能通常 20 分钟到 1 小时不等。安装完成后Windows 用户记得把 TeX Live 的 bin 目录加入系统 PATH安装器一般会自动处理但偶尔会漏装完最好验证一下。3. 配置清华镜像源与宏包更新3.1 用 tlmgr 把源切到清华TeX Live 装好之后管理宏包和更新的工具叫tlmgrTeX Live Manager。默认它指向官方源国内用起来很慢。切换源的方法很简单打开命令行Windows 用 cmd 或 PowerShellmacOS/Linux 用终端执行tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet执行完没有任何报错就说明切换成功了。你可以用tlmgr option repository查看当前源地址确认一下。这一步做完后续所有宏包更新都会走清华源速度飞快。3.2 更新宏包与常见报错处理切换源之后执行更新命令tlmgr update --self tlmgr update --all第一条是更新tlmgr自身第二条是更新所有已安装的宏包。第一次更新可能会花点时间因为要同步索引。如果遇到权限问题Linux/macOS 常见在命令前加sudo。如果遇到某个宏包更新失败通常是网络抖动重跑一次tlmgr update --all即可。有个坑我要提前说tlmgr update --all偶尔会因为某个宏包依赖冲突而中断报错信息里会提到具体是哪个包。这时候你可以先跳过它用tlmgr update --all --exclude 包名更新其他的等官方修复后再单独更新那个包。别因为一个包卡住就以为整个环境坏了。3.3 验证镜像是否生效想确认自己真的在用清华源可以跑一个测试tlmgr install geometry如果已安装会提示 already installed。观察下载速度如果几秒钟就完成说明源生效了。或者直接看tlmgr option repository的输出地址里带tuna.tsinghua.edu.cn就对了。这个验证步骤看似多余但能帮你排除以为切了源其实没切的低级错误。4. TeXstudio 的安装与中文环境配置4.1 下载安装 TeXstudioTeXstudio 的官方下载地址是texstudio.org进去选对应系统的安装包。Windows 用户下载.exe安装程序一路下一步即可。macOS 用户下载.dmg拖进 Applications 文件夹。Linux 用户可以用包管理器装比如 Ubuntu 下sudo apt install texstudio但要注意源里的版本可能偏旧追求新版的话去官网下 AppImage。安装 TeXstudio 本身没什么难度真正需要注意的是装完之后它能不能找到你刚装的 TeX Live。TeXstudio 启动时会自动搜索系统中的 LaTeX 发行版正常情况下能自动识别。如果识别不到你需要手动在选项 → 设置 TeXstudio → 命令里把各个命令的路径指向 TeX Live 的 bin 目录比如C:\texlive\2024\bin\windows\pdflatex.exe。4.2 配置中文编译XeLaTeX 是首选这是新手最容易翻车的地方。默认的pdflatex编译器对中文支持很差直接编译中文会报错或者输出乱码。解决办法是改用XeLaTeX编译器它对 Unicode 和系统字体支持极好。在 TeXstudio 里设置的方法打开选项 → 设置 TeXstudio → 构建把默认编译器改成XeLaTeX。然后你的.tex文件开头要引入中文支持宏包。推荐用ctex宏包它是目前中文排版最省心的方案\documentclass[UTF8]{ctexart} \begin{document} 你好世界这是一段中文测试。 \end{document}ctexart是ctex宏包提供的文档类专门为中文优化会自动处理字体、行距、段落缩进这些细节。如果你用的是标准article类那就用\usepackage{ctex}引入。两种方式都行ctexart更省事。4.3 字体缺失与中文乱码的排查有时候你用了ctex还是报字体找不到的错这通常是因为系统里没有它默认想要的字体。Windows 上一般不会有这个问题因为中文字体齐全。Linux 上可能需要额外装中文字体比如sudo apt install fonts-noto-cjk。macOS 上一般也没问题。如果编译出来中文显示为空白或者方框先检查三件事一是编译器是不是 XeLaTeX二是文件编码是不是 UTF-8三是ctex宏包有没有正确引入。这三个都对了中文基本不会出问题。我见过有人折腾半天最后发现是文件保存成了 GBK 编码改成 UTF-8 就好了。5. 从零编译第一个文档并验证环境5.1 写一个包含公式和图片的最小示例环境装好了得跑个完整的例子验证一下别等到写论文时才发现某个功能不能用。下面这个示例涵盖了中文、数学公式、图片、表格这几个最常用的功能\documentclass[UTF8]{ctexart} \usepackage{amsmath} \usepackage{graphicx} \usepackage{booktabs} \begin{document} \section{测试章节} 这是一段中文正文用来验证中文排版是否正常。 \subsection{数学公式} 行内公式$E mc^2$。 行间公式 \begin{equation} \int_{0}^{\infty} e^{-x^2} dx \frac{\sqrt{\pi}}{2} \end{equation} \subsection{表格} \begin{table}[h] \centering \begin{tabular}{lcc} \toprule 项目 数值 单位 \\ \midrule 长度 10 cm \\ 宽度 5 cm \\ \bottomrule \end{tabular} \caption{示例表格} \end{table} \end{document}图片部分需要你准备一张图片放在同目录下然后加\includegraphics[width0.5\textwidth]{图片名}。第一次跑先不加图片确认公式和表格没问题再加图片测试。5.2 编译流程与 PDF 预览在 TeXstudio 里按 F5 或者点那个绿色的编译按钮它会自动调用 XeLaTeX 编译。编译成功后右侧会弹出 PDF 预览。TeXstudio 默认开启正向搜索和反向搜索在源码里按住 Ctrl 点某个位置PDF 会跳到对应位置在 PDF 里双击某处源码会跳到对应行。这个功能写长文档时极其好用一定要学会用。如果编译报错TeXstudio 底部的日志面板会显示错误信息。新手看日志容易懵我的建议是先看第一个错误因为后面的错误往往是第一个错误引发的连锁反应。常见错误无非是宏包没引入、括号不匹配、命令拼写错误这几类。5.3 编译失败的典型原因清单我把新手最常遇到的编译失败原因整理成表方便你对照排查报错关键词可能原因解决办法File xxx.sty not found宏包未安装tlmgr install 包名Undefined control sequence命令拼写错误或宏包未引入检查拼写补\usepackageMissing $ inserted数学符号写在了文本模式用$...$包裹公式中文乱码或空白编译器或编码问题改 XeLaTeX存 UTF-8Emergency stop严重语法错误看日志第一个错误定位这张表建议收藏能解决你八成以上的编译问题。6. 装完之后必须知道的几个实操经验6.1 项目文件组织与备份习惯LaTeX 项目会产生一堆辅助文件.aux、.log、.out、.toc等等这些是编译中间产物不用管它们但也不要手动删正在用的。真正要备份的是.tex源文件、.bib参考文献文件、图片资源。我习惯给每个项目建一个文件夹里面再分figures子文件夹放图片源文件放根目录这样结构清晰迁移也方便。另外强烈建议用 Git 管理你的论文源文件哪怕只是本地仓库。LaTeX 源文件是纯文本Git 管理起来非常合适改崩了随时回滚。我读研时有一次误删了一整章内容幸好有 Git五分钟就恢复了。这个习惯越早养成越好。6.2 宏包冲突与版本回退宏包装多了偶尔会冲突典型表现是某个命令突然报already defined。这时候先别慌看日志里是哪个宏包和哪个宏包打架。解决办法通常是调整\usepackage的顺序或者用\usepackage[options]{pkg}加选项禁用冲突功能。实在不行可以用tlmgr回退某个宏包到旧版本tlmgr install 包名版本号。TeX Live 每年发一个新版本旧版本一般还能用一两年。如果你学校模板明确要求某个年份的版本那就别急着升级用对应年份的 ISO 装。升级大版本建议在新学期开始前做别在论文冲刺阶段折腾环境这是血泪教训。6.3 编辑器之外的效率工具TeXstudio 自带的补全已经不错但如果你想要更强的体验可以了解几个方向。参考文献管理可以用 Zotero 配 Better BibTeX 插件自动生成.bib文件。公式输入可以用截图识别工具或者学一点常用的数学符号命令。表格生成可以用在线工具生成骨架再微调。这些工具不是必须的但能显著提升效率等你熟悉基础流程后再逐步引入。我个人最推荐的效率提升是熟练使用代码片段功能。TeXstudio 支持自定义 snippet比如你经常写矩阵可以定义一个快捷键一敲就出来\begin{pmatrix}...\end{pmatrix}的骨架。这种小优化积累起来写文档的速度会有质的提升。7. 关于镜像源和环境的长期维护7.1 定期更新与版本冻结的平衡环境装好不是一劳永逸的。宏包会更新TeX Live 会发新版。我的建议是平时保持tlmgr update --all每月跑一次保持宏包较新但在论文投稿或答辩前一个月冻结环境不再更新任何东西避免更新引入意外问题。这个平时更新、关键期冻结的策略是我用了多年最稳妥的做法。如果你需要长期复现某个环境可以把当前安装的宏包列表导出tlmgr list --only-installed packages.txt将来换机器时照着这个列表装能最大程度还原环境。这个技巧在团队协作或者换电脑时特别有用。7.2 遇到镜像同步延迟怎么办清华镜像虽然快但偶尔会有同步延迟表现为某个刚发布的宏包在清华源上还搜不到。这时候你有两个选择临时切回官方源装那个包装完再切回清华源或者等一两天让镜像同步完成。切换源就是重新执行一次tlmgr option repository命令指向官方源https://mirror.ctan.org/systems/texlive/tlnet装完再切回来。这个操作不复杂但要知道有这个可能性别以为是环境坏了。7.3 多版本共存与切换有些时候你确实需要同时装两个年份的 TeX Live比如一个用来写新论文一个用来编译学校的老模板。TeX Live 支持多版本共存装在不同目录即可。切换的方法是把当前要用的版本的 bin 目录放到 PATH 最前面或者用 TeXstudio 的命令设置里直接指定某个版本的完整路径。多版本共存会占用更多磁盘但确实能解决兼容性问题有需要的话值得配置。写到这里环境搭建的完整链路就讲完了。从选型逻辑到镜像配置从中文处理到编译验证再到长期维护每一步我都尽量把为什么讲清楚。LaTeX 的学习曲线确实比 Word 陡但一旦环境跑通、工作流建立起来你会发现写长文档、管理公式和参考文献的效率是 Word 完全比不了的。先把这套环境装好然后找一份学校的论文模板把里面的示例内容编译一遍你就正式入门了。剩下的语法和技巧都是在实际写作中一点点积累的不用急着一次学完。