LaTeX 这东西第一次装的人十个里有八个会卡在下载速度上。TeX Live 完整版安装包好几个 GB默认从海外源拉取慢的时候能让你怀疑人生。我见过太多人卡在 install-tl-windows.bat 正在下载 这个界面半小时不动最后直接放弃。其实只要把镜像源换成清华的整个下载过程能从一小时压缩到十几分钟。这篇内容就是把我自己反复装过十几台机器Windows、Linux、Mac 都有的经验整理出来从镜像配置到 TeXstudio 中文环境调优一步步说清楚。不管你是完全没碰过 LaTeX 的小白还是装过但被速度劝退的老哥照着走都能搞定。1. 装之前先想清楚为什么是 TeX Live TeXstudio 这套组合1.1 LaTeX 发行版和编辑器的关系别搞混了很多人一开始就懵LaTeX 到底是个啥我到底要装几个东西这里先把概念理清楚。LaTeX 本身只是一套排版格式的定义它需要依赖一个发行版才能跑起来。发行版里打包了编译器比如 pdflatex、xelatex、lualatex、宏包、字体、文档工具等等。你可以把发行版理解成一个工具箱LaTeX 是图纸编辑器是工作台。目前主流的发行版有三个发行版平台支持特点适合谁TeX LiveWindows/Linux/Mac 全平台宏包最全跨平台一致更新稳定绝大多数用户尤其是需要跨平台的人MiKTeX主要 Windows按需下载宏包初始体积小磁盘空间紧张、网络环境好的 Windows 用户MacTeX仅 Mac本质是 TeX Live 的 Mac 定制版Mac 用户我推荐 TeX Live 的理由很直接跨平台一致。你在 Windows 上写的文档拿到 Linux 服务器上编译宏包版本、字体配置基本不会有差异。MiKTeX 的按需下载听起来很美好但实际用起来经常遇到编译到一半提示缺宏包然后卡住等下载的情况网络一波动就报错体验很割裂。编辑器这边TeXstudio 是我用过对新手最友好的一个。它有语法高亮、自动补全、错误提示、PDF 预览联动、中文界面而且完全免费开源。对比一下TeXworksTeX Live 自带的极简但功能太少不适合长期用。VS Code LaTeX Workshop功能强大但配置门槛高新手容易在 JSON 配置文件里迷路。Overleaf在线版不用装但免费版有编译时长限制且必须联网。TeXstudio开箱即用中文支持好该有的功能都有配置项直观。所以这套组合的逻辑是TeX Live 提供完整的编译能力TeXstudio 提供舒适的编辑体验。装完这两个你就能覆盖 95% 以上的 LaTeX 使用场景。1.2 清华镜像到底加速了什么这里要澄清一个常见误解清华镜像不是加速安装包下载这么简单它加速的是整个安装过程中的宏包拉取。TeX Live 的安装器在运行时会从远程仓库下载大量文件。默认源在国外国内访问经常几十 KB/s甚至断连。清华 TUNA 镜像站同步了完整的 TeX Live 仓库国内访问速度能到几 MB/s 甚至十几 MB/s。具体来说镜像加速体现在两个阶段安装阶段安装器从镜像源拉取所有宏包和二进制文件。日常使用阶段用tlmgr更新宏包时也从镜像源拉取。所以配置镜像不是装的时候用一下而是装完之后还要保持配置这样后续更新才不会又变慢。注意清华镜像地址是https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet这个地址在安装器和 tlmgr 配置里都会用到记不住没关系后面会给出具体操作。2. 下载与安装 TeX Live从镜像到落地的完整流程2.1 获取安装器别去官网直接下TeX Live 官网tug.org提供的安装器是个网络安装器体积很小几十 MB但运行时要从远程拉取所有内容。如果你直接从官网下这个安装器它默认连的还是国外源照样慢。正确做法是直接从清华镜像下载安装器这样安装器本身就已经配置好了镜像源。Windows 用户的操作打开浏览器访问清华镜像的 TeX Live 目录https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/找到install-tl-windows.exe点击下载。下载完成后不要直接双击运行。右键选择以管理员身份运行或者先解压再运行。为什么强调管理员权限因为 TeX Live 默认安装到C:\texlive目录需要写入系统盘。如果权限不够安装到一半会报无法写入文件的错误而且这种错误往往在安装快结束时才出现非常浪费时间。Linux 用户更简单直接用 wgetwget https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet/install-tl-unx.tar.gz tar -xzf install-tl-unx.tar.gz cd install-tl-* sudo ./install-tlMac 用户建议直接装 MacTeX它本质是 TeX Live 的定制版下载地址同样可以在清华镜像找到。不过 MacTeX 的完整包很大4GB如果磁盘紧张也可以装 BasicTeX 然后用 tlmgr 按需装宏包。2.2 安装器配置镜像源和安装方案的取舍运行安装器后你会看到一个命令行界面Windows 下是带 GUI 的。这里有几个关键选择第一确认镜像源。如果你是从清华镜像下载的安装器它默认已经指向清华源。但保险起见在安装器界面里找到 Change default repository 或类似选项确认地址是https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet如果不是手动改掉。这一步决定了后面下载速度。第二选择安装方案。安装器提供几种预设full scheme完整安装约 7-8 GB包含所有宏包和字体。basic scheme基础安装约 200 MB只含最核心的宏包。medium scheme中等约 1-2 GB。我的建议是如果你磁盘空间够至少留 15 GB直接选 full scheme。理由很实际——LaTeX 的宏包依赖关系复杂你永远不知道自己哪天会用到哪个宏包。用 basic 方案编译时经常遇到 File xxx.sty not found然后要手动tlmgr install非常打断写作节奏。full 方案一次装完后面省心。如果磁盘实在紧张选 medium scheme 也能覆盖大部分场景缺什么再补。第三调整安装路径。默认路径是C:\texlive\2024年份会变。如果你 C 盘空间紧张可以改到其他盘比如D:\texlive\2024。但要注意路径里不要有中文和空格否则后续某些工具会出问题。第四勾选安装完成后添加环境变量。这个选项在不同版本里叫法不同有的叫 Add TeX Live to PATH有的在安装完成后单独提示。一定要勾上否则你在命令行里敲pdflatex会提示不是内部或外部命令。配置完成后点击安装然后就是等待。用清华源的话full scheme 大概 15-30 分钟能装完具体看网络。装的过程中可以干别的但别关窗口。2.3 验证安装三个命令确认环境正常装完之后打开一个新的命令行窗口重要必须是新开的否则环境变量不生效依次运行tex --version pdflatex --version tlmgr --version三个命令都能输出版本信息说明安装成功。如果tlmgr报错大概率是环境变量没配好手动加一下Windows 下把C:\texlive\2024\bin\windows加到系统 PATH 里。Linux/Mac 下在~/.bashrc或~/.zshrc里加export PATH/usr/local/texlive/2024/bin/x86_64-linux:$PATH路径里的年份和平台架构按实际情况改。实操心得我遇到过好几次命令能跑但 tlmgr 报错的情况最后发现是 PATH 里同时存在多个 TeX Live 版本系统调用了旧版的 tlmgr。解决办法是用which tlmgrLinux/Mac或where tlmgrWindows确认调用的是哪个然后把旧版本从 PATH 里移除。3. TeXstudio 安装与中文环境配置3.1 下载安装避开捆绑陷阱TeXstudio 的官网是 texstudio.org但国内访问有时候慢。更稳的方式是从清华镜像或 GitHub Release 下载。Windows 用户注意官网下载页有时候会引导你到一些第三方下载站那些站点的安装包可能捆绑了其他软件。认准官方渠道或者直接用清华镜像里的版本。安装过程没什么坑一路下一步就行。唯一要注意的是安装路径同样避免中文和空格。装完之后第一次打开界面可能是英文的。改成中文Options→Configure TeXstudio→Language→ 选zh_CN。如果没有中文选项说明你的版本没带中文翻译去官网下最新版即可。3.2 配置编译器XeLaTeX 是中文文档的首选这是新手最容易踩的坑用默认的 pdflatex 编译中文文档会报一堆错。原因在于 pdflatex 对 Unicode 和中文支持不好需要额外配置字体和编码非常麻烦。而XeLaTeX 原生支持 Unicode 和系统字体编译中文文档几乎零配置。在 TeXstudio 里设置默认编译器Options→Configure TeXstudio→Build找到Default Compiler改成XeLaTeX找到Default Bibliography Tool改成Biber如果你用 biblatex 管理参考文献设置完之后新建一个文档测试\documentclass[UTF8]{ctexart} \begin{document} 你好LaTeX这是一个中文测试文档。 \end{document}按 F5 编译如果能正常生成 PDF 并显示中文说明配置成功。ctexart是 ctex 宏包提供的文档类专门为中文排版设计会自动处理字体、行距、标点等细节。如果你用article类需要手动加载\usepackage{ctex}。3.3 中文词典和拼写检查TeXstudio 默认的拼写检查是英文的中文文档里会满屏红波浪线很影响观感。解决办法有两个方案一关闭拼写检查。Options→Configure TeXstudio→Spelling→ 取消勾选Check spelling。简单粗暴但英文拼写错误也检查不出来了。方案二添加中文词典。下载zh_CN.dic和zh_CN.affHunspell 格式的中文词典放到 TeXstudio 的词典目录下然后在设置里选中文。这个方案更优雅但找词典文件稍微费点事。我个人的做法是写中文文档时关掉拼写检查写英文文档时再打开。因为中英混排时拼写检查的误报率很高与其被红波浪线干扰不如手动切换。注意TeXstudio 的拼写检查只影响编辑器的显示不影响编译结果。所以关掉它不会对你的文档产生任何实质影响。4. 镜像源的持续维护装完之后别就不管了4.1 tlmgr 换源让宏包更新也走高速通道很多人装完 TeX Live 就不管了结果几个月后想更新宏包发现tlmgr update --all慢得要命。这是因为 tlmgr 的默认源还是国外的。换源命令tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet运行完之后再执行tlmgr update --self和tlmgr update --all速度会明显提升。Windows 用户如果 tlmgr 命令找不到用完整路径C:\texlive\2024\bin\windows\tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet4.2 宏包安装按需补充的正确姿势即使装了 full scheme偶尔还是会遇到缺宏包的情况比如某些新出的宏包还没进 full 方案。这时候用tlmgr install 宏包名比如缺algorithm2etlmgr install algorithm2e如果提示找不到可能是宏包名不对去 CTAN 网站搜一下确认。另外有些宏包有依赖tlmgr 会自动处理不用手动装依赖。实操心得我建议每隔一两个月跑一次tlmgr update --all保持宏包更新。但不要在论文截稿前一周更新因为新版本宏包偶尔会引入不兼容的改动导致原本能编译的文档报错。这个坑我踩过截稿前一天更新完发现某个宏包改了接口连夜回滚。4.3 常见安装报错速查报错信息原因解决办法I cant find file xxx.sty缺宏包tlmgr install xxxFont xxx not found字体缺失换用系统已有字体或安装对应字体包tlmgr: command not found环境变量没配手动添加 PATHPermission denied权限不足Windows 用管理员运行Linux 加 sudo编译卡住不动宏包下载慢检查镜像源配置中文显示为方框字体问题用 XeLaTeX 编译确认 ctex 宏包已加载这张表覆盖了我遇到过的 90% 的安装和编译问题。遇到报错先查表大部分能直接解决。5. 从零到一第一个完整文档的实操演示5.1 项目结构别把所有东西堆在一个文件里新手常犯的错误是把所有内容写在一个.tex文件里。文档一长找内容就变成灾难。正确的做法是分文件管理myproject/ ├── main.tex # 主文件负责组织结构和编译 ├── chapters/ │ ├── intro.tex # 第一章 │ └── method.tex # 第二章 ├── figures/ # 图片目录 │ └── diagram.png ├── refs.bib # 参考文献 └── main.pdf # 编译输出主文件main.tex长这样\documentclass[UTF8, a4paper, 12pt]{ctexart} \usepackage{graphicx} \usepackage{amsmath} \usepackage{geometry} \geometry{left2.5cm, right2.5cm, top2.5cm, bottom2.5cm} \title{我的第一个 LaTeX 文档} \author{你的名字} \date{\today} \begin{document} \maketitle \tableofcontents \newpage \input{chapters/intro} \input{chapters/method} \end{document}用\input{}引入子文件编译时只需要编译main.texTeXstudio 会自动处理依赖。5.2 插入图片和表格两个高频操作的细节插入图片\begin{figure}[htbp] \centering \includegraphics[width0.8\textwidth]{figures/diagram.png} \caption{这是一张示例图片} \label{fig:example} \end{figure}几个关键点[htbp]是位置参数表示这里、顶部、底部、单独一页LaTeX 会自动选最合适的位置。别用[h]强制当前位置容易导致排版难看。width0.8\textwidth表示图片宽度为文本宽度的 80%比写死像素值更灵活。\label{}用于交叉引用正文里用\ref{fig:example}引用。插入表格\begin{table}[htbp] \centering \caption{示例表格} \begin{tabular}{|c|c|c|} \hline 列1 列2 列3 \\ \hline A B C \\ D E F \\ \hline \end{tabular} \label{tab:example} \end{table}表格自动换行是个常见需求。如果单元格内容太长用p{宽度}代替c\begin{tabular}{|p{3cm}|p{5cm}|}这样列宽固定内容会自动换行。5.3 编译流程XeLaTeX Biber 的正确顺序如果你用了参考文献biblatex biber编译顺序很重要第一次 XeLaTeX 编译生成 .aux 文件Biber 编译处理参考文献第二次 XeLaTeX 编译插入参考文献第三次 XeLaTeX 编译修正交叉引用TeXstudio 里按 F5 是编译按 F11 是编译参考文献按 F12 是查看 PDF。但更省事的方式是配置一键编译Options→Configure TeXstudio→Build→Build View改成txs:///compile | txs:///bibtex | txs:///compile | txs:///compile | txs:///view这样按一次 F5 就能完成整个流程。注意如果你不用参考文献可以忽略 biber 步骤。但一旦用了就必须按顺序编译否则引用会显示为[?]。6. 新手最容易踩的五个坑6.1 路径里有中文或空格这是最隐蔽的坑。TeX Live 和某些宏包对路径中的非 ASCII 字符处理不好路径里有中文会导致莫名其妙的报错比如文件找不到但文件明明存在。解决办法项目路径和安装路径都用纯英文。比如D:\latex_projects\paper1不要用D:\我的文档\论文。6.2 用 pdflatex 编译中文前面提过但值得再强调一次。pdflatex 编译中文需要\usepackage[utf8]{inputenc}加\usepackage{ctex}而且字体配置经常出问题。直接用 XeLaTeX省去所有麻烦。6.3 忘记编译多次LaTeX 的交叉引用、目录、参考文献都需要多次编译才能正确显示。第一次编译后看到[?]或目录为空不要慌再编译一两次就好了。6.4 宏包冲突有时候加载两个宏包会冲突报错信息往往很隐晦。常见的冲突组合hyperref和某些宏包的加载顺序问题hyperref 一般放最后加载geometry和ctex的页边距设置冲突多个图表宏包之间的命令重定义遇到冲突时先注释掉最近添加的宏包逐个排查。6.5 磁盘空间不足full scheme 装完加上编译产生的中间文件很容易占用 10 GB 以上。如果 C 盘紧张安装时就改到其他盘。另外编译产生的.aux、.log、.out等中间文件可以定期清理TeXstudio 里有清理辅助文件的功能。7. 装完之后让这套环境真正为你所用环境装好了接下来就是用它写东西。我给新手的建议是别一上来就啃 LaTeX 语法大全那样很容易劝退。正确的路径是找一个现成的模板学校论文模板、期刊模板、简历模板直接编译跑通。在模板基础上改内容遇到不会的语法再查。逐步积累自己的常用代码片段比如图片、表格、公式的写法。LaTeX 的学习曲线确实比 Word 陡但一旦过了那个坎你会发现它在处理长文档、复杂公式、参考文献管理上的效率是 Word 完全比不了的。尤其是写论文格式自动统一、引用自动编号、目录自动生成这些省下来的时间远超学习成本。我自己的经验是从装好环境到能独立写一篇带公式、图片、参考文献的文档大概需要一到两周的碎片时间。关键是要动手写光看教程不动手永远学不会。最后分享一个实用技巧TeXstudio 里按CtrlSpace可以触发自动补全输入\beg然后按补全会自动展开成\begin{}...\end{}的完整结构。这个功能用熟了写代码的速度能快一倍。另外CtrlT可以注释选中行CtrlU取消注释调试时非常方便。