环境搭建：TeX Live、MacTeX 与 Overleaf

装环境往往是劝退新人的第一道门槛：下载好几个 GB 的镜像、配置编辑器、第一次编译还可能因为缺字体失败。本文按「云端优先、本地兜底」的顺序给你三条可用路径，并说明各方案在磁盘空间、离线能力与协作上的取舍。讲完后还附上一份环境验收清单，让你在半小时内确认环境真的能用，而不是等到写完十页文档才发现编译链路某处断了。

一、先选方案：云端、本地还是混合

三种主流方案的差别不在排版质量（背后编译器完全一样），而在使用方式与维护成本。先把结论摆出来，再逐条解释。学生党尤其注意：学校机房若禁止安装软件，云端方案就是唯一可行的路径。

对绝大多数初学者，建议顺序是：先用 Overleaf 跑通前三五个练习，零配置地建立对编译结果的整体感受；确认自己愿意继续投入后，再装本地环境做长期写作。两者并不冲突——平时在本地写，需要远程协作或跨设备演示时把项目打包上传云端即可。选择时真正要权衡的是两件事：你的网络是否稳定决定云端体验，你的磁盘空间是否宽裕决定本地方案。其余因素对初学者影响不大。

还有一条容易被忽略的建议：无论选哪种方案，都尽早把项目纳入文件夹管理——每篇文档一个独立目录，图片放子目录，源码、图片、输出文件分层存放。云端平台天然提供项目管理，本地则需要自己建文件夹。习惯分层的目录结构后，迁移到任何环境都不需要重新整理，这也是后续「交源码包」场景的前置准备。

二、Overleaf：零配置的云端起点

Overleaf 的使用几乎不需要说明：注册账号、新建项目、选模板、点 Recompile。但有四个细节值得记住，能省去后面很多困惑。

编译器切换这一步最关键：新项目默认是 pdfLaTeX，中文文档若不切到 XeLaTeX，很可能整页空白或乱码。这台云服务器背后的引擎与本地完全相同，因此你在 Overleaf 上学到的命令迁移到本地后依然有效。遇到报错时，它的日志面板与本地 .log 文件内容一致，读日志的方法在任何环境都通用——排错链条见本站的编译排错章节。另一个实用技巧：把常用项目设为模板，新文档从模板创建，导言区配置就不用每次重写。

云端方案还有两个隐性好处值得知道。其一，它内置了常用宏包与字体的完整环境，本地缺字体报错的问题在云端几乎不存在；其二，链接分享即可协作，对方不需要装任何东西。对应的代价是：免费档有编译时长与项目数上限，断网时完全无法工作。把它当作入门与协作工具，把本地环境当作长期主力，是多数人的最终配置。

三、本地安装：Windows、macOS 与 Linux

Windows 推荐 TeX Live 的完整安装：从官网下载在线安装器，选择完整安装，耗时约一小时，安装器会自动设置系统环境变量。macOS 用户用 MacTeX，它是 TeX Live 的 macOS 定制版，额外附带 GUI 工具（编辑器与文献管理）。Linux 用户可用发行版自带的 texlive-full，或用官方安装器获得更新版本。

xelatex --version

装完后在命令行运行上面这条命令，输出版本号即表示引擎可用。如果提示找不到命令，多半是环境变量未生效，重新打开终端或检查安装器的 PATH 选项即可。安装后第一次编译若报缺字体，先别怀疑安装失败——多数情况下是文档没指定引擎，详见中文支持一章。

跨平台还有一点提醒：移动硬盘或 U 盘里直接编译项目容易因路径与字体差异失败，请在每台机器的本地磁盘上工作。

磁盘吃紧的同学可以选最小安装，缺宏包时用包管理命令按需补装；但要有心理准备：中文宏集、Beamer、文献工具分散在多个分类里，补装过程对新手并不友好——有时缺一个宏包要连带上层依赖一起找。权衡之下，完整安装的一次性等待往往是总成本最低的选择。

安装时间较长时可以做一件正事：趁等待把后续章节的示例先在纸上或云端跑一遍。完整安装的一大好处是「接下来几个月不被缺宏包打断」，这在赶 deadline 时价值极高——没有什么比交稿前夜发现缺一个宏包更搞心态的了。

四、编辑器：TeXstudio、VS Code 与 TeXShop

装好 TeX 后还需要一个编辑器写源码。编辑器只是壳，真正的编译由背后的 TeX 引擎完成，所以换编辑器不影响文档兼容性。TeXstudio 跨平台、自带命令补全与正反向跳转（点 PDF 跳到源码位置，反向亦可），对新手最友好；VS Code 配合 LaTeX 插件更灵活，适合已经习惯它的同学；macOS 的 TeXShop 开箱即用。

关键配置只有一项：把默认编译器改成 xelatex。TeXstudio 在选项的构建设置里改，VS Code 在配置文件中指定编译工具链。为什么必须改？因为中文文档依赖 xelatex 的字体能力，默认的 pdflatex 编译中文会失败——原理在中文支持章节有完整解释。编辑器选哪个都不影响最终 PDF 的质量，唯一影响的是你写码时的顺手程度，不必在选型上纠结太久。

判断编辑器是否适合自己的最短路径：各试用半天，看哪个的「编译—看 PDF—改源码」循环最顺畅。正反向跳转是这项循环的加速器，几乎所有主流编辑器都支持，只看默认是否开启。

五、验收清单与辅助工具

一个可用的环境应当满足下面的清单。逐项确认能避免后期大量莫名其妙的报错，建议每换一台电脑就过一遍。

另推荐两个辅助工具：latexmk 用来自动决定编译遍数，避免手动重复执行编译命令的繁琐；BibDesk 或 JabRef 用来可视化管理文献数据库。前者是本站「第一个文档」一章演示编译流程时的核心工具；把环境验收清单存进自己的知识库（搭建方法见本站的Obsidian 指南），换电脑时就能逐项核对。关于写作过程中如何用 AI 辅助检查命令写法，本站的AI 辅助写作提供了提示词模板。

验收完成后，建议再做一个压力测试：新建一个同时包含中文段落、数学公式、图片与列表的文档编译一次。这四项覆盖了九成以上的日常需求，全部正常即说明环境真正就绪，之后写长文档时再遇到问题，基本可以排除环境因素、专心查源码。

环境配好后不要急着写长文档。先用一个包含中文与一张图片的最小例子确认编译链路通畅，再开始正式内容。验证通过后把这份最小文档另存为「环境检查模板」，之后每次换环境都先跑它一遍，三十秒就能心里有底。下一节我们就来写这第一个文档，并把源文件结构与编译流程一次讲清。

延伸阅读

• 论文写作指南
• AI 辅助写作
• 正则表达式
• Obsidian 知识管理