企业官网建设流程全解析

1. 这份LaTeX常见问题整理，到底能帮你省下多少时间

很多人第一次接触LaTeX，是被导师或编辑部逼的——论文模板发过来，后缀是.tex，打开一看满屏反斜杠，整个人是懵的。我在过去几年里帮同学、同事改过不下几十份LaTeX文稿，自己也从零开始搭过学位论文、期刊投稿、会议海报，踩过的坑可以说遍布安装、编译、排版、引用的各个环节。这份LaTeX常见问题整理，就是把那些在群里被问了无数次、在论坛里翻了好几页才找到答案的问题，集中成一份可以直接照着操作的清单。它适合所有正在用或准备用LaTeX的人，不管你是第一次装环境的研究生，还是已经被公式和表格折磨好几周的论文作者，这份整理都会比你自己踩坑来得快。

先说清楚LaTeX到底解决什么问题。它本质上是一套基于TeX的排版系统，核心思想是"内容和样式分离"：你只管写内容，用命令声明结构，版式交给宏包和编译引擎去处理。好处是，当你的文档有几十个公式、上百条引用、一堆交叉引用时，LaTeX能自动维护编号和链接，这是Word很难做到的。但坏处也很直接——它是一个"工具链"，安装、编译、排错每个环节都有门槛。我见过太多人卡在第一步配环境就不想动了，也有人写到一个公式对齐问题就心态崩了。

这份整理的目的很朴素：把高频问题集中拆解，每个问题都给出为什么会出现、怎么解决、怎么预防的完整思路。我不打算讲晦涩的TeX底层机制，所有内容都以"能跑通、能排出好效果"为准。你完全可以把这篇文章当一个速查手册，遇到问题翻到对应章节，照着做就行。

2. 安装与编辑器：还没开始写正文，就先被环境绊倒

2.1 发行版怎么选：TeX Live还是MiKTeX，我的建议很直接

这是第一个高频问题，也是很多人纠结最久的问题。TeX Live和MiKTeX是目前最主流的两个TeX发行版，功能上基本等价，真正影响选择的其实是使用场景和网络环境。

TeX Live是每年发布一次完整镜像，安装完就是全量宏包，大约7到8个GB。它的优点是一步到位，几乎所有宏包都已经在本地，后面不会遇到"缺宏包临时下载"的尴尬。缺点是占空间，初次安装时间长。如果你在国内网络环境下还要在线更新，速度可能会很折磨人。我用TeX Live的一个体会是，它对多用户、跨平台的一致性很好，实验室里几个人用同一个版本的TeX Live，编译结果不会因为宏包版本不同出现差异，这在多人协作写论文时特别重要。

MiKTeX则走的是"按需安装"路线，默认只装基础部分，用到哪个宏包现场下载。它的安装包很小，几百MB就能开始用，适合磁盘紧张或者只想偶尔写点东西的人。但"现场下载"在编译高峰期可能变成"现场卡住"，尤其是网络环境不稳定的时候，一次编译卡在Downloading package上，会让人非常抓狂。另一个潜在风险是，同一个文档在不同时间编译，宏包版本可能已经变了，这在复现实验结果排版时是个隐患。

我的建议是：如果你是学生、要写学位论文、或者长期和LaTeX打交道，直接装TeX Live，找一个镜像源一次性装完，后面省心。如果只是帮人改几页东西、机器上不想装太大体积，MiKTeX也完全够用。两个发行版的宏包语法基本兼容，文档换机器通常不会因为发行版不同而编译失败，所以不用在这件事上内耗太久。

2.2 编辑器搭配：VS Code配置LaTeX Workshop，第一关怎么过

环境装好了，还得有一个好用的编辑器。很多人上来就用记事本写.tex，然后跑到命令行里敲latexmk，这不是不行，但效率确实低。我目前的主力方案是VS Code加LaTeX Workshop插件，配合TeX Live，一套配置下来体验很流畅。这个方案的优势在于：

• 实时编译预览，保存后自动刷新PDF
• 内置SyncTeX，PDF里点一下可以跳回源码位置
• 自动补全和错误提示比较到位

具体配置不算复杂，但有几个坑要提醒。第一，装完LaTeX Workshop后，它会自动查找系统里的latexmk可执行文件，如果之前没有把TeX Live的bin目录加进系统PATH，插件的编译按钮会报"recipe not found"之类的问题。解决办法是在VS Code的settings.json里显式指定latex-workshop.latex.tools，把latexmk的完整路径写进去，路径类似C:\texlive\2023\bin\windows\latexmk.exe。第二，如果你用中文文件名或者带空格的路径，建议从一开始就用英文路径建项目文件夹，LaTeX对路径中的空格和中文支持虽然比过去好很多，但在一些宏包和工具链组合下仍可能出幺蛾子。

还有一个小技巧，很多人不知道LaTeX Workshop支持right-click编译，就是你在.tex文档里点右键就能看到"Build LaTeX project"菜单。我习惯在写完一段内容后手动按一次Ctrl+S，让它自动编译，然后开预览窗口双栏对照，改动能立刻看到效果，排版调整的反馈速度快到接近实时。这一步体验做好了，后面使用的心情都会好很多。

重要提醒：VS Code里如果遇到编译没反应，先看输出面板（Output）里的Log，不要只看终端。LaTeX Workshop的日志把每一步命令都打出来了，报错在哪几乎一眼就能定位。

2.3 初装环境最常见的三类坑，一次说透

环境问题归纳起来其实就是三类：找不到命令、缺宏包、权限受限。

找不到命令的表现是，在终端里敲xelatex提示"不是内部或外部命令"，但GUI编辑器里又能编译。这通常说明PATH没配好。Windows下装TeX Live时，安装器一般会自动配置PATH，但如果你手动改过环境变量或者装了精简版，就可能漏掉。解决办法是把texlive\2023\bin\windows这个目录加到系统PATH里，然后重开终端。macOS下则要留意shell配置文件，装了TeX Live后可能需要source ~/.zshrc才能生效。

缺宏包的问题在TeX Live里很少见（因为全量安装），在MiKTeX和在线编辑器里比较常见。提示信息一般是File 'xxx.sty' not found。这种情况下，首先确认宏包名字是不是正确，有些宏包名字和引用的文件名不完全一致，比如fontawesome5宏包的引用名是fontawesome5，不用管版本号。确认名字没问题后，在终端执行tlmgr install 宏包名（TeX Live）或者打开MiKTeX Console安装，再重新编译。如果宏包是CTAN上的新包，tlmgr也装不了，就需要手动下载.sty文件放到项目目录下的texmf文件夹，这个操作我后面会细讲。

权限受限则多发生在公司电脑或实验室公用机器上，安装时没把TeX目录写入用户目录，编译生成的文件写到系统盘被拦。这种问题最快的解决方法是改latexmkrc配置里的输出目录，让编译产物落在项目子文件夹，而不是系统临时目录。一句话总结：环境问题不是技术难度问题，而是路径和权限的"体力活"，按顺序排查即可。

3. 中文支持与编码：绕不开的"中式"难题

3.1 编译引擎：为什么你的中文显示成乱码或者直接报错

如果你用LaTeX写过中文，肯定见过这种情况：用默认的pdfLaTeX编译，中文变成一堆乱码，或者干脆报Unicode character ... not set up for use with LaTeX。问题的根源在于，pdfLaTeX对UTF-8的支持是有限的，中文属于多字节字符，需要特定的字体和编码映射才能工作。解决中文支持的最主流方案是使用XeLaTeX或LuaLaTeX这两个引擎，它们原生支持系统字体和UTF-8输入。

实际使用上，我推荐直接用XeLaTeX，兼容性在中文场景里最稳定。你只需要在导言区加入：

\documentclass{ctexart} % 或者使用ctex宏包 \usepackage{ctex}

ctex宏包会帮你处理好中文字体、标点压缩、行距调整等一堆杂事，基本上你什么都不用管，正文直接写中文就能编译通过。如果用\documentclass{article}再手动加\usepackage{ctex}也不是不行，但要留意默认字号和章节格式可能和ctexart有细微差异。做学位论文时学校给模板一般会指定文档类，照搬即可。

还有一点容易忽略：源文件编码格式。TeX Live的现代版本已经对UTF-8支持得很好了，但如果你在Windows下用了记事本保存为带BOM的UTF-8，某些宏包遇到BOM会报奇怪的错误。我习惯用VS Code或Sublime Text保存为UTF-8 without BOM，这个设置能省掉非常多"莫名奇妙"的报错。

3.2 中文字体设置：怎么换字体、为什么有些字体不生效

ctex宏包默认会找系统里的中文字体。Windows上一般会用宋体、黑体、楷体，macOS上会用Songti、Heiti，Linux上如果没有预装中文字体，会降级到一些开源字体。如果你的系统里某个字体缺失，编译时会报font not found之类的问题，或者退回到一个很奇怪的字形。

换中文字体的标准写法是这样的：

\documentclass[fontset=windows]{ctexart} \usepackage{ctex} \setCJKmainfont{SimSun} % 设置正文宋体 \setCJKsansfont{SimHei} % 无衬线 \setCJKmonofont{KaiTi} % 等宽

需要注意的是，这些字体命令要在导言区调用，\setCJKmainfont接收的是系统字体名，不是文件名。如果你的文档要在别人机器上编译，最好确认对方机器也有这些字体，否则就会出现"我这里编译好好的，换台电脑就字全没了"的经典场面。稳妥的做法是使用ctex自带的字体集选项，比如直接用\documentclass[fontset=windows]{ctexart}，它会自动匹配一套常用的中文字体组合。也有一种情况是自定义字体名拼写错误，报错信息很含糊，提示找不到字体，这时候去系统字体管理里复制准确的字体名，比靠记忆输入靠谱。

3.3 编码与特殊字符：中文引号、空格、注释符带来的隐形坑

中文环境下有个很容易被忽略的问题：全角符号和TeX命令的冲突。比如中文引号" "在LaTeX源码里可以直接用，但如果从Word里复制过来，可能变成两个连续的"或"，编译后输出效果不统一。我的经验是，中文字符在LaTeX里大多可以直接写，但引号最好在源码里统一成中文全角引号，不要混用英文引号。

另一个高频坑是空格。LaTeX默认会忽略多个连续空格，这在英文排版里是特性，但在中英文混排时可能会造成"单词间距不统一"的视觉问题。如果你需要在中英文之间加一个固定大小的空隙，可以用~（不可断空格），这样既能防止换行断开，又能保证间距一致。

注释符%也容易踩坑。很多人会在代码里写类似50%，不加反斜杠的话，LaTeX会把%之后的内容全当成注释，导致后面的文字整段消失。正确写法是50\%。中文文档里如果出现百分号，也记得加转义，这是初学者最常犯的低级错误之一，但往往要到很晚才发现，因为前一页的内容被静默吞掉了。

4. 公式、表格、图片：排版三件套的主战场

4.1 公式编号与对齐：多行公式怎么排得专业又不报错

公式是LaTeX的看家本领，也是使用频率最高的功能。最基础的单行公式用\[ ... \]或者equation环境，但真正让人头疼的是多行公式的对齐和编号。我见过最多的求助帖是关于align环境里多行等式的&对齐符怎么用，以及如何在多行公式里只给某一行加编号。

一个非常实用的写法是：

\begin{align} a &= b + c \\ d &= e + f \nonumber \end{align}

&定义了对齐位置，\\换行，\nonumber去掉当前行的编号，\tag{...}可以自定义编号。这里有个细节：align环境每个&会形成一个"对齐列"如果你在一个公式里放了两个&，LaTeX会把它们按奇数列对齐，结果可能和你预期不一样。我通常用alignat环境处理多列对齐，它的对齐规则更可控。

跨行的长公式怎么拆也很讲究。一般建议在运算符处换行，比如+、-、=前面断开，并且下一行开头用\quad缩进，形成视觉上的延续感。在数学模式下，换行不能直接按回车，必须用\\或者\newline，但这两个在equation环境里是违法的，只能配合align或split环境使用。如果你公式太长需要跨页，最好不要单独用多个公式环境，而是用split环境结合equation环境，让编号和换行都能自动化处理。

4.2 表格宽度与跨页：调一个表调一晚上，到底有没有套路

LaTeX表格的默认行为是"内容多大，格子多大"，不会自动撑满版心宽度。很多人排三线表时会发现表格比正文窄一截，或用\resizebox把表格缩到很小，字体比例失调。我的建议是使用tabularx宏包，它可以让表格列宽自适应剩余宽度：

\usepackage{tabularx} \begin{table}[htbp] \centering \begin{tabularx}{\textwidth}{l X X} 列1 & 列2 & 列3 \\ ... \end{tabularx} \end{table}

其中X列类型表示"拉伸到剩余宽度"，\textwidth表示表格总宽度等于版心宽度。这个方法在期刊投稿里特别实用，因为期刊对表格宽度要求苛刻，直接指定绝对宽度比反复试p{}列宽靠谱得多。

跨页表格则是另一个重灾区。默认的table环境是浮动体，不能跨页；你看到表格跨页的需求，应该使用longtable宏包，或者更现代的ltablex结合tabularx。注意，longtable的语法和table环境不太一样，表头需要用\endhead标记，如果你直接用\hline，编译时可能会报Misplaced \noalign之类的问题。还有一个经验之谈：表头行重复出现（\endhead后面的内容）在每一页开头都会打印，所以把列名放到\endhead上方就行。

经验：如果表格里的内容比较长、内容里有换行，不要自己手动用\\，而是用p{Xcm}列类型或tabularx的X列，让内容自动换行。手动换行一旦列宽调整，整个表格就全乱了。

4.3 图片路径与浮动体控制：图不出现、图乱跑、图挤在一起

图片的经典三问：图不出现、图跑到别的章节去了、图挤在一起。第一个问题先检查路径，\includegraphics{figures/myfig}里的路径是相对于当前.tex文件所在目录的，不是相对于编译命令执行目录。很多人把图片放在子文件夹却用了相对根目录的路径，编译时不报错，但PDF里就是空白的。

第二个问题，图片位置乱跑，根源是LaTeX的浮动机制。\usepackage{graphicx}配合figure环境会把图片当成浮动体，LaTeX会权衡"当前页剩余空间够不够""如何排版更美观"，于是图片可能被安排到几页之后。解决方案有两种：一是调整浮动参数，比如\begin{figure}[H]（需要float宏包），强制图片就在当前位置；二是用[htbp]并接受浮动规则，让LaTeX自己安排，但最后多做一次手动微调。学位论文往往要求图随文走，我一般用[htbp]加\clearpage配合控制，把图固定在大致位置，又不会因为强制位置造成页尾大片空白。

第三个问题，多张图片横向并排时挤在一起，可以用minipage或者subfigure宏包：

\begin{figure}[htbp] \centering \begin{minipage}{0.48\textwidth} \includegraphics[width=\textwidth]{fig1} \end{minipage} \hfill \begin{minipage}{0.48\textwidth} \includegraphics[width=\textwidth]{fig2} \end{minipage} \end{figure}

关键点是两个minipage的宽度之和不要超过1，加上中间的\hfill作为弹性间距，这样两张图自然分布在两侧。如果宽度设成0.5+0.5，中间再加一个空格，就可能撑出页边距。

5. 参考文献管理：从手抄清单到自动化，这一步值得花时间

5.1 BibTeX和BibLaTeX，怎么选才不后悔

参考文献是LaTeX相对Word最大的优势之一，但也是配置复杂度的高发区。核心思路是：把参考文献存成.bib文件，文章里用\cite{key}引用，编译时自动生成文献列表和标注。让人困惑的是，网上教程一会教你用BibTeX（bibtex命令），一会叫你用BibLaTeX（biblatex宏包+biber命令），两者语法和依赖项完全不同。

我的建议是：如果是从零开始、且不依赖老项目的模板，直接用BibLaTeX。它的功能更现代，支持完整的姓氏拆分、多种引用样式、预印本条目类型等，对中文文献的支持也更友好。导言区配置：

\usepackage[style=gb7714-2015,backend=biber]{biblatex} \addbibresource{references.bib}

正文引用处用\cite{key}，然后文档末尾用\printbibliography输出文献表。编译顺序变成了：XeLaTeX -> biber -> XeLaTeX -> XeLaTeX。注意，不能用bibtex命令编译BibLaTeX的文档，否则会报I found no \citation commands或Biblatex is not compatible with bibtex之类的错误。

反过来，如果项目模板强依赖BibTeX，比如某些老期刊的模板还停留在natbib风格，那就老老实实继续用BibTeX，保持bibtex命令和\bibliography{...}结构，不要强行混用。BibTeX的样式文件（.bst）选择是通过\bibliographystyle{plain}控制的，想换成国标就找gbt7714-plain这类bst文件放到项目目录里。

5.2 引用失效、编号乱跳、文献表重复，这五个检查点先过一遍

引用类问题排查起来是有套路的，按以下顺序检查，基本能覆盖九成情况。

第一，确认.bib文件路径写对了，且文件编码是UTF-8。Windows下用记事本保存的.bib可能是ANSI，Biber和BibTeX对编码非常敏感，常导致中文文献乱码或直接不显示。

第二，确认条目键值（key）没有重复，正文里的\cite{key}和.bib里的@article{key}必须一字不差。多一个空格、大小写不一致都会变成"?".，编译过程还不会报致命错误。

第三，检查编译顺序。BibTeX/Biber生成参考文献靠的是辅助文件（.aux或.bbl），如果你只编译一次就打开PDF，参考文献肯定是空的或过期的。推荐用latexmk这个命令，它会自动判断需要跑多少次XeLaTeX和biber。

第四，看看是不是多个文件分散了引用。如果用了\include分章节，\printbibliography一定要写在最终输出的那个根文件（main.tex）的最后，写在某个子文件里可能不会输出完整文献表。

第五，编号乱跳通常是引用了不存在的键，或者biber中途报错后生成了残缺的.bbl文件。这种情况先删掉临时文件（.aux、.bbl、.bcf），再重新完整编译一遍。很多人遇到文献消失或编号乱跳时，其实只是没清理临时文件而已。

独家技巧：我习惯在main.tex里加一行\usepackage[backend=biber,style=gb7714-2015]{biblatex}后，再设置latexmk -pdfxe -interaction=nonstopmode main.tex作为标准编译命令。latexmk会自动检测BibLaTeX依赖项并安排正确的编译轮次，不只是省一次按键，更重要的是避免"我用biBer编译但命令跑的是bibtex"这类混乱。

6. 报错信息看不懂？这份速查表能帮你少掉一半头发

6.1 高频编译错误速查表：错误信息到底在说什么

LaTeX的报错信息普遍不友好，动辄一大段英文加一个"!"开头，很多人看到就慌。其实大部分错误可以归纳成几类。我把两年里收集到的最高频错误做成了速查表，你可以直接对照排查。

表格里最常见的其实是Missing $ inserted.。很多人写正文时直接写了_或者^，LaTeX自动进入了数学模式然后报错。这个错误可以"修复"，但你一定要回头检查自己是不是真的想用下标，如果是在描述文件名（比如C++里的加号，或者Test_2024里的下划线），就要转义成\_，C++写成C++要用C\texttt{++}或者C++直接写但加入某种等宽环境。

还有一类"静默错误"特别害人：编译完全不报错，但输出内容和源码对不上。比如注释符%吞掉内容、全角符号变成乱码、图片空白不报错。这类问题的排查方法只有一个：把源码从头到尾检查，尤其是最近改动过的部分。

6.2 排错三板斧：从懵圈到定位的五分钟路径

遇到疑难杂症，我有一套固定流程，能帮你在五分钟内定位大部分问题。

第一板斧，看日志文件而不是只看编译窗口。编辑器提示的信息往往是截断或者经过美化处理的，真正的细节都在.log文件里。在项目目录下找到main.log，打开后直接搜索!（英文感叹号），每出现一个感叹号就是一次错误点，向前翻几行能看到出错的源码位置。比较麻烦的是，有些宏包的错误会在!上方有几条warning，它们是诱因，需要一起看。

第二板斧，二分注释法。把.tex内容对半砍，注释掉后半部分，编译看是否还报错；如果正常，把范围缩小到后半部分，再对半分；如果还报错，问题就在前半部分。反复几次，十几行的代码量几分钟就能定位到出错的宏包或命令。这个方法虽然笨，但在面对复杂的宏包冲突时是最高效的，因为很多报错没法靠读代码看出来。

第三板斧，清理临时文件。.aux、.toc、.lof、.out这些辅助文件会在多次编译后累积陈旧信息。当你修改了章节结构或引用了新标签后，不清理临时文件可能造成编号不同步、目录错误、引用失效。在项目目录执行：

latexmk -c # 或者手动删除 .aux .bbl .bcf .blg .toc .lof .lot .out .fls .fdb_latexmk

然后重新完整编译。这个操作能解决一大批"昨天还好好的，今天就莫名报错"的问题。

6.3 宏包冲突与版本兼容：有些事情只能是经验之谈

宏包冲突是最难排查的一类错误，因为报错信息经常很晚才出现，甚至出现在和问题宏包完全无关的地方。我总结出几个经验，虽然不能覆盖所有情况，但至少能帮你少绕弯道。

第一，如果一个宏包功能重叠，就尽量不要同时加载两个。比如subfigure和subcaption都管子图，加载两个会冲突；float和placeins都管浮动体位置，加载顺序不对也会出问题。我的原则是：能用新宏包就不用老宏包，subcaption优先于subfigure，biblatex优先于natbib（除非模板强制）。

第二，注意宏包的加载顺序。按经验法则，先加载fontenc、inputenc（或ctex），再加载图形、浮体类，再做页面布局，最后加载hyperref。hyperref一般要放在最后，因为它会重新定义很多命令，加载太早容易和其他宏包打架。如果你对顺序没把握，最简单的做法是"越通用的宏包越早加载，越特殊的越晚加载"。

第三，如果你用了\usepackage{geometry}设置页边距，又同时用了\usepackage{fullpage}，两者会冲突，最终页边距完全由一个宏包说了算，另一个静默失效。这类问题没有报错，最坑人。排查方法是逐个宏包注释掉，然后对比PDF输出差异。

一个重要提醒：当你把编译好的PDF发给导师或同事时，一定要确认对方是否也在同一套编译引擎下工作。宏包版本差异导致同一份源码在不同机器上排版结果不同，这个我在协作时踩过多次，后来干脆约定大家都用同一年的TeX Live镜像，问题就消失了。

7. 写在最后：我的LaTeX使用习惯和一些私藏技巧

文章写到这里，该整理的问题基本都覆盖了。最后分享几个我个人的使用习惯，算不上什么系统方法论，但都是实践中觉得非常省心的操作。

第一，从第一天开始就建立main.tex、chapters/、figures/、references.bib这个基础目录结构，哪怕只是一篇小短文也这么建。养成习惯后，你永远知道图片放哪里、章节怎么切分、参考文献怎么组织，不会出现"所有东西堆在同一个文件夹，最后连自己都找不到了"的场面。

第二，在main.tex开头配置一个\newcommand系列，给常用的复杂命令起一个简短的别名。比如我写实验报告时经常用到"相对误差"，就定义成\newcommand{\relerr}[2]{\left|\frac{#1-#2}{#2}\right|}，正文里直接\relerr{计算值}{真值}，省去大量重复代码。这个习惯对长文档的影响巨大，你会发现写到后面，你主要的工作是组织内容而不是调格式。

第三，不要过度纠结某些"最好"的方案。LaTeX的生态里，很多问题都有至少两三种标准解法，比如浮动体位置控制、表格宽度适配、字体设置，没有绝对正确，只有适合当前文档的做法。用最稳妥、你最熟的方案把事情做完，比花大把时间研究"更优雅"的做法更符合写论文的本质。

最后说一句心得：LaTeX的学习曲线确实陡，但一旦跨过去，你会发现自己再也不愿意回Word去手动调编号和图注了。学会看日志、学会二分排查、学会维持一个干净的项目结构，这三点比记住任何一条命令都重要。这份LaTeX常见问题整理未必能覆盖你遇到的所有问题，但它提供了一套可复用的思考框架——先定位，再对症，最后预防。希望它能在你被满屏反斜杠困住的时候，帮你省下一点宝贵的头发和时间。