OmniDocLaTeX翻译后编译报错，怎么一步步排查
LaTeX源文件翻译成中文后编译失败？本文按先易后难的顺序，讲清怎么读编译日志、怎么判断报错属于哪一类、各类问题怎么修，以及怎样避免下次再出错。
如果你把一份 LaTeX 源码包翻译成中文，结果重新编译时满屏红字，或者干脆生成不了 PDF，这篇文章就是为你写的。很多人遇到这种情况会直接重翻一遍，结果报错依旧。其实大多数编译失败都能在源文件里找到具体位置，改几行通常就能恢复。
读完这篇，你会知道怎么读编译日志、怎么判断报错属于哪一类，以及每类问题该怎么修。这里讲的是通用排查方法，不依赖某一款工具。它只关心译后编译失败这件事，不讨论翻译方法本身。
下面的内容按先易后难的顺序展开。你可以先对照表格找到自己的情况，再照着步骤逐项检查。
编译报错要不要重新翻译？一句话结论
多数情况下不需要重翻，先看日志定位报错位置，再按原因修改源文件即可。下面这张表给出了常见情况和对应做法。
| 你的情况 | 推荐做法 | 原因 |
|---|---|---|
| 中文显示为方块，或提示字符无法编码 | 改用 xelatex 或 lualatex，并加载 ctex 宏包 | pdflatex 默认不直接支持中文字符 |
| 报错行落在公式里 | 检查译文是否把中文放进了数学环境，或误改了符号 | 数学模式里的文字和符号规则与正文不同 |
| 提示命令未定义，命令名变成了中文 | 把命令名还原成原文 | 翻译时把命令当成普通词汇译掉了 |
| 只有引用、图表或参考文献报错 | 核对 \label、\ref、\cite 键名和文件名 | 键名被改动后，交叉引用找不到目标 |
| 报错多且分散在各处 | 与原文件逐段对比，或注释掉一半缩小范围 | 可能是批量替换或编码问题，逐段定位更快 |
先判断是哪一种问题
拿到报错后，先把症状和常见原因对上号，能省去大量无效尝试。下表列出了译后编译常见的几类问题。
| 症状 | 常见原因 | 怎么确认 |
|---|---|---|
| 提示 Undefined control sequence，名字是中文或奇怪字符 | 命令名被翻译 | 在源文件中搜索报错的名字，看它是否跟在反斜杠后面 |
| 提示 Missing } inserted 或 Extra } | 花括号数量不对 | 在报错行附近逐个数 { 和 }，留意译文里的全角括号 |
| 提示 \begin{...} ended by \end{...} | 环境标签不成对 | 搜索所有 \begin 和 \end，核对数量和环境名 |
| 中文乱码，或提示 Unicode 字符无法处理 | 编译引擎或文件编码不对 | 确认文件保存为 UTF-8，并换用 xelatex 或 lualatex |
| 提示 Missing $ inserted | 数学模式没有闭合 | 检查译文里未闭合的 $、\( 或 \[ |
| 提示 File not found，或图片不显示 | 文件名或路径被改动 | 核对 \includegraphics 与 \bibliography 中的文件名 |
| 参考文献显示为问号 | 键名不一致，或参考文献没有重新生成 | 核对 \cite 键名与 bib 文件中的键名，再多编译几遍 |
逐项排查和修复
建议按下面的顺序检查，靠前的步骤通常省事。
- 先读日志，找靠前的那个错误。日志中以感叹号开头的行是错误，紧跟其后的 l. 加数字就是源文件的行号。只处理这一个错误，修好后再重新编译，观察后续报错是否减少。
- 回到报错行，与原文对照。把译文那一行和原文对应段落并排看，常见差异是多出的花括号、被翻译的命令名，或者全角符号。
- 确认编译引擎。含中文的源文件通常需要 xelatex 或 lualatex，并在导言区加载 ctex 宏包（例如写入 \usepackage{ctex}）。换引擎后先不改其他内容，看中文能否正常显示。
- 检查成对结构。逐一核对 \begin 与 \end、花括号和 $ 符号是否成对。译文中常见的问题是把全角的「｛」「｝」误当作花括号，或在段落中留下未闭合的 $。
- 检查命令和键名。搜索源文件中所有以反斜杠开头的命令，确认没有被译成中文；再核对 \label、\ref、\cite 的键名与原文完全一致。
- 检查资源路径。确认图片、bib 文件与主文件在同一目录，或路径写法正确，文件名的大小写也要与原文一致。
- 每改一处就重新编译一次。如果一次改动很多，出错时就无法判断是哪一步起了作用。
中文显示异常怎么修
先检查导言区是否加载了中文宏包，再确认文件保存为 UTF-8，最后把引擎换成 xelatex 或 lualatex。如果只有个别字符显示为方块，通常是字体缺失，可以在 ctex 的字体设置中换一种已安装的中文字体。
公式和命令被误译怎么修
公式内部的符号、变量和命令应保持原文，只把公式前后的说明文字译成中文。如果无法确定是哪一处出了问题，可以用二分法：在主文件中用 % 注释掉前一半内容，重新编译；若能通过，问题就在后一半，如此逐步缩小范围。
引用和图片找不到怎么修
交叉引用和参考文献需要多轮编译才能生成完整，所以出现问号时先多编译两到三次。若问号仍然存在，再回头核对键名。图片报错则重点看路径和扩展名是否与原文件一致。
怎样避免下次再出现
- 翻译前先保留一份原始版本，并确认原文能够正常编译。如果原文本身就报错，后面的问题就无法判断是译文造成的。
- 翻译前列出一份不可改动清单，包括所有命令、环境名、公式、\label、\cite 键名和文件路径，只允许修改自然语言段落。
- 统一把源文件保存为 UTF-8，并在导言区固定中文设置，避免每次换环境都要重新调整。
- 译后先编译，确认无误后再逐段人工核对。机器翻译的结果难免有遗漏或误译，论文、合同等重要内容尤其需要逐句核对。
- 每完成一个章节就保存一个版本，出错时可以回退到最近一次能编译的状态，而不必从头排查。
❓ 常见问题（FAQ）
1. 日志里有很多警告，要不要全部处理？
不必。警告通常不会阻止 PDF 生成，先处理以感叹号开头的错误，错误清零后再看是否还有影响阅读的警告。
2. 用 pdflatex 报错，换成 xelatex 就能编译，是不是说明译文没问题？
不一定。换引擎只说明中文编码和字体问题已经解决，译文中的花括号、命令名和键名仍可能有错，需要继续按上面的步骤检查。
3. 想保留原来的格式，翻译时应该怎么设置？
可以在 omnidoc.top 上传 LaTeX 源码包，选择仅译文或双语对照后下载结果。无论选哪种方式，都建议用上面的清单核对公式、交叉引用和文件路径，再重新编译确认。
4. 挑选 latex 中文翻译软件时，应该看哪些指标？
优先看它是否保留公式、命令和交叉引用，是否支持整个源码包，以及对文件大小和隐私的说明。如果只能得到一段段的纯文字，编译时仍会出现大量结构性错误。
📝 总结
LaTeX 翻译成中文后编译报错，大多数情况下是引擎、花括号、命令名或键名的问题，按日志靠前的错误逐项修改即可解决。坚持每次只改一处、译后先编译再核对，能显著减少反复返工。
