不妧写给自己Blog的时候，我一向不太愿意把“本地部署”说得太玄。LaTeX本身不复杂，复杂的是第一次装环境时那些碎到不能再碎的坑。这篇我把从安装、配置、写公式、插图片到排参考文献的完整路径整理出来，尽量按我实际操作过的顺序写，你照着走一遍，应该就能把自己的本地LaTeX环境稳稳跑起来。
1. LaTeX本地部署先想清楚：哪些场景真的需要本机环境
1.1 在线编译越来越卡，真正卡在什么地方
先说一个很现实的问题：在线LaTeX编辑器用了两三年，文档页面刚过三十页，每次编译要等十几秒，git版本管理还老和自动保存打架，那你就到了该考虑本地部署的节点了。LaTeX本地部署，本质上是把编辑器、LaTeX发行版、PDF预览器和参考文献工具链全部装到自己的操作系统里，所有编译动作在本地CPU上完成，不依赖任何网页服务。
为什么本地环境对长文档更有优势，核心原因有三点：
- 编译速度稳定。在线服务高峰时段经常排队，本地编译基本是秒开，尤其是增量编译的时候，改一个小错误只重编受影响的部分。
- 断网可用。我赶过好几次高铁上改论文的稿子，离线环境下在线编辑器直接罢工，本地TeX Live没有任何影响。
- 包管理和模板自由。在线平台能装的宏包有限，遇到期刊模板要求特定版本宏包，本地环境可以手动装任意版本，自由度完全不一样。
适合参考这篇内容的人，我大致分三类：正在写本科或研究生学位论文的同学、需要频繁改投期刊模板的研究人员、以及所有工作中要处理公式和报告模板的工程师。如果你只是偶尔写两页带公式的作业，其实在线编辑器足够了，没必要折腾本地部署。
1.2 TeX Live和MiKTeX怎么选：一张表说清
本地部署LaTeX的第一步是选发行版。主流的就两个：TeX Live和MiKTeX。这两个不是LaTeX本身，而是把LaTeX引擎、数百个宏包、字体和工具打包到一起的“发行版”，理解成“LaTeX生态的一键安装包”就行。
我自己在Windows上主力用TeX Live，在Linux服务器上也装过TeX Live，MiKTeX只在一台老笔记本上试过。两者的差异我用一个表格直接说清：
| 对比维度 | TeX Live | MiKTeX |
|---|---|---|
| 默认安装体积 | 完整版约7-8GB | 基础安装小，宏包按需自动下载 |
| 宏包安装方式 | 安装时全量打包，装完即全部可用 | 编译时缺哪个包自动装哪个 |
| 跨平台能力 | Windows / macOS / Linux统一 | 偏Windows，Mac版也有但用得少 |
| 更新机制 | tlmgr统一管理 | 自带更新管理器 |
| 稳定性 | 年度发布，版本固定，适合学术写作 | 自动装包方便，但偶尔遇到版本兼容问题 |
| 适合人群 | 论文写作者、对稳定性要求高的人 | 硬盘紧张、只偶尔用LaTeX的人 |
我的建议很直接：如果你不知道自己选什么，直接装TeX Live完整版。7GB对现在的主流固态硬盘不算大，换来的是“编译到任何一个宏包都不会提示missing”的安心感。MiKTeX适合那种纯粹想写个几十行公式、连宏包概念都不想了解的人，但一旦论文开始引用大量包，按需下载装包的过程反而让人烦躁。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 从零开始装环境：TeX Live安装、VS Code配置与首次编译
2.1 安装TeX Live时我踩过的三个选择
TeX Live安装看起来是“下一步下一步”，但有几个选项第一次装很容易忽略。我以Windows环境为例，在macOS和Linux上思路完全相同，只是安装包形态不一样。
第一件事，去TeX Live官网找到install-tl的下载页面。Windows下下载zip包，解压后进目录运行install-tl-windows.bat，会弹出字符界面的安装菜单。这个界面不是图形化，很多人第一次看到以为出错了，其实这是正常界面，用键盘上下键和回车操作。
安装菜单里我最关注三个配置项：
- 安装方案（scheme）。默认是
full scheme，这就是完整版。千万不要为了省空间选basic或small，后面每缺一个包都要手动装，成本远超省下的那点磁盘空间。 - 安装目录。Windows默认是
C:\texlive\2024，建议保持默认，后面配环境变量时路径好记。 - 字体和符号包。完整版会自动带上所有font和latex packages，不需要单独勾选。
安装时长取决于网络速度。我第一次装大概花了四十分钟，主要是下载几百个package的归档。安装完成后，把C:\texlive\2024\bin\windows加入系统的Path环境变量，这个步骤非