企业官网建设流程全解析

1. 先说清楚：LaTeX 到底是干嘛的

很多第一次接触 LaTeX 的朋友，看到这个奇怪大小写的名字就有点发怵，其实它解决的是一个非常具体的问题：写文档里的数学公式和复杂排版。

我当年第一次在 Word 里敲分段函数的大括号时，光是调整公式对齐就折腾了快一节课，后来换成 LaTeX 之后，感觉自己从“手抄排版的小工”变成了“写代码的工程师”。你把内容用纯文本写好，交给编译器，出来的 PDF 排版工整、公式漂亮，参考文献、目录、交叉引用全部自动管理。简单说，LaTeX 是“用写代码的方式写文档”。

这篇博文面向的是完全零基础的新手，目标只有一个：让你从“听说 LaTeX 这个名字”到“本地环境装好、能编译出第一份中文 PDF”，中间不踩多余的坑。我会结合自己在 Windows 和 macOS 两种系统上的实际安装经验，把下载地址、安装选项、编辑器配置这些环节全部过一遍，顺带解释每个选择背后的原因。

如果你是在校学生要写毕业论文、理工科要投期刊论文、或者程序员想维护一份带公式的项目文档，这篇内容可以直接照抄作业。

2. 方案选型：为什么我推荐 TeX Live + VSCode

2.1 发行版之争：TeX Live、MacTeX、MiKTeX 怎么选

搞 LaTeX 得先明白一个概念：LaTeX 本身并非独立软件，而是建立在 TeX 排版引擎之上的一套宏集，实际使用中需要“发行版”把编译引擎、宏包、字体、文档工具打包在一起。目前主流的选择有三个，不少新手在这里就卡住了。

MiKTeX 是 Windows 出身的老牌发行版，特点是可以按需安装宏包——用到了才下载，省硬盘空间。听上去很美好，但实际用起来有个很烦的毛病：编译到一半突然弹出“正在安装缺失宏包”的提示，然后整个编译流程卡住，尤其在办公室、学校这种网络不稳定的地方，体验相当割裂。

TeX Live 是跨平台的完整发行版，宏包非常齐全，基本你能想到的宏包它都预装好了，而且每年更新一个大版本。缺点是安装包体积较大，完整安装大概要 7~8 GB 的磁盘空间，下载也需要一点时间。但我个人的态度很明确：与其日后被宏包缺失和网络问题反复折磨，不如一次装个完整版的 TeX Live。

macOS 上对应的是 MacTeX，你可以把它理解成 mac 版的 TeX Live 套件，里面额外整合了 Ghostscript、LaTeXiT 这些小工具。所以，如果你用的是 Mac，直接装 MacTeX 就行，不用折腾太多；Windows 和 Linux 用户则选择 TeX Live。

2.2 编辑器选择：VSCode 为什么比 TeXstudio 更合适

安装完发行版，你还需要一个编辑器来写.tex文件。网上能看到很多 TeXstudio 的教程，它确实是专门的 LaTeX 编辑器，集成了一些按钮，但实话说，界面风格停留在十年前，而且它的配置逻辑和主流编码工具是脱节的。

我推荐 VSCode，理由很实在：VSCode 有一套非常成熟的 LaTeX Workshop 插件，编译、查看 PDF、错误跳转一条龙，体验相当顺畅。更重要的是，VSCode 不只是一个 LaTeX 编辑器，你后面写 Python、改 markdown、处理前端代码都会用到它，只需装一次，学到的东西也能复用到其他领域。

当然，如果你完全不想接触代码类工具，只想双击打开快速写论文，Overleaf 这类在线平台更方便，但它是另一条路线，这篇博文聚焦在本地安装，因为我们最终要处理的是本地环境。用 VSCode 还有个好处是，它能把反向同步（正反向搜索）做得很顺滑——光标在 PDF 里点一下，直接跳到源代码对应位置，这个功能在大文档写作里简直是救命的。

3. 下载与安装全流程：Windows 和 macOS 各来一遍

3.1 Windows 安装 TeX Live 的详细步骤

第一步是下载安装包。请直接去 TeX Live 的官方页面：https://tug.org/texlive/，点页面上的“download”按钮，选择从国内的镜像站下载，比如清华大学的 TUNA 镜像、中科大的 USTC 镜像，速度会快很多，直接挂官方源很容易慢到怀疑人生。

Windows 用户下载下来的通常是一个名为install-tl-windows.exe的可执行文件。双击运行之前，建议先关掉杀毒软件和系统防火墙对未知程序的实时监控，因为安装过程中要往系统目录写入大量字体和可执行文件，部分安全软件会误报或者拦截导致安装中断。我见过不下五次安装到一半报错，最后发现都是杀毒软件在背后捣鬼。

运行安装程序后，界面会出现一些配置项，大部分保持默认即可，但有两点值得手动改一下。第一，安装方案（scheme）建议选择“full scheme”——也就是完整安装全部宏包，这一步可以有效避免后续写作时动不动就缺宏包的问题；第二，安装目录建议保持默认的C:\texlive\，因为后续配置环境变量和 VSCode 插件的路径基本都是按照默认值来找的，改了反而容易出岔子。至于“安装字体到系统”这个选项，务必勾选上，不然你在系统其他程序里看不到 TeX Gyre 这些 LaTeX 字体。

点击安装后，整个过程视机器性能和磁盘速度，大概需要 20 到 60 分钟不等。这个阶段不用干等着，你可以先去把 VSCode 下载好，再准备一份测试使用的.tex文档。安装期间 tee 界面会不断滚动宏包列表，属于正常现象，不必惊慌，最终出现“安装完成”字样即可。

安装完成后，你可能需要重启一次终端窗口，让PATH环境变量生效。在命令行输入xelatex -v，如果能看到版本号输出，说明 TeX Live 已经正常进入了系统。

3.2 macOS 安装 MacTeX 的详细步骤

macOS 用户就简单得多。前往https://tug.org/mactex/页面下载 MacTeX.pkg 安装包，注意体积比较大，将近 4~5 GB，请预留足够的磁盘空间并保持网络稳定。

下载完成后双击.pkg文件，系统会引导你一路点击“继续”，最后输入本机管理员密码完成安装。安装程序会自动把 TeX Live、Ghostscript、LaTeXiT 等组件装到/usr/local/texlive/目录下，同时帮你把环境变量写进 shell 配置文件中。

安装完成后，打开“终端”App，输入xelatex -v验证。如果提示“command not found”，不要慌，大概率是你使用的 shell 配置文件还没有加载新路径。macOS 默认的 zsh 会读取~/.zshrc，你可以手动执行一行命令：

echo 'export PATH="/usr/local/texlive/2024/bin/universal-darwin:$PATH"' >> ~/.zshrc source ~/.zshrc

不同年份的 MacTeX，路径里的年份数字要对应你安装的版本；如果你不知道路径，也可以先在“访达”里进入/usr/local/texlive/看看到底是哪个文件夹。确认xelatex -v能输出版本号之后，安装部分就算完成了。

3.3 安装后的基础命令与环境验证

这里额外说一个新手常见困惑：写完.tex文件之后，到底用什么命令编译？

很多人一开始只知道pdflatex，但如果你要写中文文档，这几乎行不通，因为 pdflatex 默认的字体编码对中文极不友好。我在实际工作中 90% 的场景用的都是xelatex，它能直接调用系统字体，配合ctex宏包，中文排版堪称完美。

建议你在终端里跑一遍这三条命令，确认编译链都是好的：

xelatex -v latexmk -v tlmgr --version

latexmk是一个自动化编译工具，它会根据文档的变化自动决定要编译几次，我们后面在 VSCode 里会用到它；tlmgr是 TeX Live 的宏包管理器，以后安装自定义宏包全靠它。

验证完命令，可以新建一个最简单的测试文件：

\documentclass{article} \begin{document} Hello, LaTeX! \end{document}

在终端里执行xelatex test.tex，如果目录下生成了test.pdf，说明环境已经通了。这一关过了，我们进入编辑器配置环节。

4. VSCode 环境配置与日常写作实战

4.1 安装 VSCode 与 LaTeX Workshop 插件

去https://code.visualstudio.com/下载对应系统的版本，安装过程一路默认即可。VSCode 安装完之后，左侧竖排有个扩展商店图标，搜索“LaTeX Workshop”，认准作者是 James Yu 的那个，安装量最大，基本没有争议。

安装完插件后，直接打开或新建一个.tex文件，VSCode 会自动识别并加载 LaTeX 环境。先别急着写内容，因为插件默认的编译工具链未必匹配你的需求，需要先做一点参数调整。

按Ctrl+,（macOS 上是Cmd+,）打开设置面板，点击右上角的“打开设置(JSON)”，在你的用户配置文件中追加如下配置项。不要担心看不懂，我逐个解释它们的作用。

{ "latex-workshop.latex.recipes": [ { "name": "xelatex", "tools": [ "xelatex" ] } ], "latex-workshop.latex.tools": [ { "name": "xelatex", "command": "xelatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%" ] } ], "latex-workshop.view.pdf.viewer": "tab" }

recipes部分定义了编译方案数组，插件的默认方案清单里没有直接暴露 xelatex 作为第一优先项，所以我这里显式指定它；tools部分的args是整个配置的灵魂：-synctex=1开启同步定位功能，让你能在 PDF 与源码之间来回跳转；-interaction=nonstopmode的意思是编译过程中遇到错误不要停下来弹窗等待用户输入，而是直接记录错误并继续，这对于自动化编译极其重要；-file-line-error让编译器输出带文件路径和行号的错误格式，方便我们直接点击跳转到出错位置。%DOC%是插件内置的占位符，表示当前文件的主文件名。

view.pdf.viewer设为tab表示在 VSCode 内置页面查看 PDF，这样编辑器和 PDF 预览能并排显示，不用来回切换窗口。

4.2 正向搜索和反向搜索的优雅配置

配置完上面的基础项，你已经可以正常编译了，但为了把体验做到最佳，建议再把正向搜索和反向搜索调通。

所谓的正向搜索，是指你在.tex源码里按Ctrl+Alt+J（或者点击右上角的小图标），PDF 预览会自动跳转到对应页面；反向搜索则是在 PDF 预览窗口里按住Cmd键点击某一行文字，VSCode 会自动把光标定位到源码中的对应行。这两者在修改大文档时效率提升非常明显。

要启用反向搜索，还需要确保 PDF 预览器是基于 SyncTeX 数据工作的。使用 LaTeX Workshop 内置的 tab 预览器时，反向搜索默认就是开启的，你只需要在 PDF 窗口处于焦点时按Cmd+点击（Windows 为Ctrl+点击）即可。如果在某些自建预览器场景下不生效，请检查编译参数里是否包含了-synctex=1，缺少这个参数，反向搜索必然失效。

有一件事要提醒：如果你用了 SumatraPDF 或者 Skim 这类外部 PDF 阅读器来做反向搜索，需要额外配置它们的命令行参数。但既然我们已经用了 VSCode 内置的 tab 预览，这个步骤就可以直接跳过了。

4.3 插入图片、表格和公式的实战经验

环境配置好后，我直接给你几个日常写作最常用的代码片段，这些是回归测试过很多次的方案，可以直接抄。

插入图片，特别是单张图并排编排，是我写技术博客时最常用的：

\begin{figure}[htbp] \centering \includegraphics[width=0.8\textwidth]{figures/architecture.png} \caption{这里是图片标题} \label{fig:architecture} \end{figure}

[htbp]是浮动体的位置参数集合，意思是“优先放在这里，放不下就依次尝试页面顶部、底部、独立页”，初学者最容易漏掉这个参数或者只写一个[h]，导致图片被编译器排到很靠后的位置；width=0.8\textwidth控制图片宽度为正文宽度的 80%，比直接用像素值更灵活；figures/architecture.png是相对路径，建议所有图片统一放在项目的figures文件夹下，后面图片多了你不会后悔这个决定。

写表格时，很多人会遇到单元格内容过长自动换行的问题。默认的tabular环境换行很痛苦，我建议直接用tabularx宏包：

\usepackage{tabularx} \begin{tabularx}{\textwidth}{|X|X|} \hline 第一列描述 & 第二列描述 \\ \hline 这里的内容如果太长会自动换行 & 这里也一样 \\ \hline \end{tabularx}

X列类型会按照总宽度自动分配每列的宽度，内容长了自动换行，根本不用手动设p{3cm}这种死板的宽度。如果你需要精确控制每列比例，可以在导言区这样写：

\newcolumntype{L}{>{\raggedright\arraybackslash}X}

数学公式是 LaTeX 的王牌功能。行间公式用\[ \]包裹，多行的用align环境：

\begin{align} E &= mc^2 \\ f(x) &= \int_0^\infty \frac{\sin x}{x} \, dx \end{align}

&是对齐点，\\是换行符，这些都是硬规则，记住就不会排版错乱。特殊符号如果记不住，推荐一个工具：https://detexify.kirelabs.org/classify.html，你手绘符号，它给你推荐对应的 LaTeX 命令，比翻符号大全效率高得多。

5. 常见问题与排查技巧实录

5.1 编译报错与宏包缺失

新手最常见的报错之一是：

LaTeX Error: File 'ctex.sty' not found.

这通常意味着你的发行版里缺少对应宏包。如果你当时安装 TeX Live 时选择了精简方案，或者用的是较早的版本，就会遇到这种问题。解决办法有两条：如果你有网络条件，可以用tlmgr install ctex命令在线安装缺失的宏包；如果安装的是完整版还报这个错，先检查一下当前正在编译的文件里有没有调用宏包的语法写错，比如拼错了包名。

还有一类报错是“Undefined control sequence”，意思是编译器遇到了一个它不认识的命令。常见原因是宏包没有引入、命令拼写错误、或者花括号没有配对。我的排查习惯是先看错误日志里第一个 TeX 报错——后面往往跟着一连串连锁错误，真正的根因通常在最前面。

维护一个自己的“宏包清单”是个好习惯。这样换电脑、换环境时能快速恢复：

ctex, amsmath, graphicx, hyperref, geometry, caption, float, tabularx, booktabs, listings

这些是我日常常用的基础宏包组合。装好环境后，提前编译一个包含这些宏包的空白文档，能一次性验证它们是否都能正常加载。

5.2 中文支持：为什么你的文档编译出来中文是空白

如果你在文档里写了中文，编译出来的 PDF 中文部分却空白或者乱码，几乎可以断定是下面两个原因之一。

第一，编译器用错了。你用了pdflatex而文档里包含了中文字符，pdflatex 的编码体系对 UTF-8 中文支持很差，会导致输出异常甚至编译失败。解决方案是统一使用xelatex进行编译，这一点我们在前面已经配置好了。

第二，文档类没有引入ctex宏包。推荐的最省心写法是：

\documentclass[UTF8]{ctexart}

ctexart是 ctex 宏包提供的中文文档类，它会自动配置中文字体、段落缩进等细节。如果你希望保留英文 article 的样式，也可以这样做：

\documentclass{article} \usepackage[UTF8]{ctex}

两种写法都行，但前者对中文文档的排版定制更友好。macOS 用户如果遇到字体相关报错，可以先执行fc-list :lang=zh查看系统里的中文字体列表，再在 ctex 里指定你要用的字体名称，例如：

\ctexset{fontset=macnew}

5.3 VSCode 插件常见问题：编译按钮灰了怎么办

LaTeX Workshop 最让人困惑的一点是：有时候你装了插件，打开了.tex文件，但左侧工具栏的“编译”按钮是灰色的，点了没反应。

排查步骤按顺序来。先确认你的PATH环境变量是否包含了xelatex的路径——插件启动时会去系统路径里找编译器，找不到的话它根本不会显示可用工具。在 VSCode 内置终端里输入xelatex -v，如果提示找不到命令，说明 VSCode 没有继承你的 shell 环境变量。

macOS 上还有个隐蔽问题：如果你从“访达”直接启动 VSCode，它可能没有加载~/.zshrc里的路径配置，导致插件了环境变量失败的假象。最简单的解决方案是先用终端命令open -a "Visual Studio Code"来启动，或者修改 VSCode 的terminal.integrated.env.osx配置，把 PATH 直接写死。

Windows 用户如果遇到这个问题，多半是安装 TeX Live 时没有勾选“修改系统 PATH”选项，手动去“系统属性 -> 环境变量 -> Path”里把C:\texlive\2024\bin\windows加上即可。路径里的年份换成你实际安装的版本。

5.4 一些用顺手了才懂的技巧

写到这里，再分享几个我自己踩过坑后总结出来的小技巧，它们能让你的 LaTeX 使用体验上一个台阶。

第一个技巧是给 VSCode 设置保存后自动编译。在配置文件里加上：

{ "latex-workshop.latex.autoBuild.run": "onSave" }

这样每次按Ctrl+S保存文档，插件就会自动执行编译与 PDF 刷新。配合 VSCode 的分屏预览模式，你写的每个字几乎实时地呈现在 PDF 里，写作节奏很舒服。这里要提醒一下：自动编译对性能有微弱影响，文档特别大时可能卡顿，到时候把它改成onFileChange或者手动编译即可。

第二个技巧是为不同项目配置独立的.latexmkrc文件。灯如果你建立了一个比较大的项目，里面既有主文件又有章节文件，推荐在项目根目录创建一个.latexmkrc，内容写清楚编译命令：

$pdf_mode = 5; $pdflatex = 'xelatex -synctex=1 -interaction=nonstopmode';

这相当于给项目定了编译规则，不管是自己用还是以后交给别人维护，都能保证编译方式统一。

第三个技巧是模板复用。第一次写完毕业论文或者期刊文章后，把导言区的内容保存成一个preamble.tex文件，以后每次开新项目直接\input{preamble.tex}，不用重新配置字体、页边距、宏包等一堆东西。长期积累下来，这套“个人模板库”的效率收益非常可观。

6. 装完环境之后，还能怎么扩展

LaTeX 的生态比很多人想象中大得多。装好本地环境只是第一步，之后还能根据自己的需求扩展很多玩法。

最常见的是使用各类模板。在https://www.overleaf.com/latex/templates上能找到大量现成的模板，但是你下载的.zip文件里的.cls文件、.sty文件、.bst文件等，要正确放置到 TeX Live 的本地目录中才能被编译时找到。在个人目录下新建~/texmf/tex/latex/结构，把模板文件丢进去，刷新文件数据库（mktexlsr或kpsewhich验证）就能正常使用。这个过程听起来简单，实际上我在这里卡过很久，所以特别提醒一下。

除此之外，本地环境还能配合 Git 做文档版本管理。你可以把.tex和图片文件纳入 Git 仓库，编译生成的.aux、.log、.pdf等中间文件写进.gitignore，这样在论文写作时能随时回退到任何历史版本，不必保存一堆文件名带“最终版 v2”的文件夹。这是我个人强烈推荐的工作流。

如果你以后要写幻灯片，LaTeX 的 Beamer 类也值得掌握——排版数学公式的 PPT 体验远超 Power Point，而且完全不需要考虑换行错乱的问题。

安装好一套 LaTeX 环境，相当于给自己置办了一套干净的写作工具，不仅是写论文，日志、简历、技术手册、甚至是给客户交付的报价单，都能用它输出高质量的 PDF。技术栈虽然有一定门槛，但投入产出比极高，值得花这几十分钟把它配置好。