LaTeX 编译错误排查
LaTeX 编译报错了怎么办？
LaTeX 编译错误虽然看起来吓人，但大多数有明确的模式可以识别。最常见的原因包括：命令拼写错误、括号不匹配、宏包冲突、图片路径错误和中文编码问题。LaTeX Agent 提供 AI 编译错误诊断功能，可以自动分析错误原因并给出修复建议，比手动排查快很多。
操作步骤
阅读错误信息，定位出错行
编译日志的第一条错误通常是最关键的。关注 '!' 开头的行和紧跟其后的描述，比如 'Undefined control sequence' 或 'Missing $ inserted'。LaTeX Agent 会在编辑器中直接标注错误位置。
按错误类型分类处理
命令未定义 → 检查拼写和宏包是否加载；缺少 $ → 检查数学模式；括号不匹配 → 用编辑器的高亮括号功能检查；文件未找到 → 检查路径和文件名大小写。
逐段注释排除法
如果错误信息不够明确，可以用 % 注释掉大段内容，逐步缩小范围。每次取消注释一小段，编译一次，直到定位到具体的出错位置。
利用 AI 辅助诊断
LaTeX Agent 的 AI 助手可以直接分析编译错误。把错误日志粘贴给 AI，或者点击编辑器中的'错误诊断'按钮，AI 会读取源文件和错误信息，给出具体的修复方案。
检查常见陷阱
中文文档是否加载了 ctex？图片格式是否为 PDF/PNG/JPG？参考文献 .bib 文件编码是否为 UTF-8？是否在导言区之前使用了文档命令？这些是最容易被忽略的错误源。
限制与注意事项
- 部分深层宏包冲突需要深入理解 LaTeX 内部机制
- 自定义命令和宏的错误可能需要逐行排查
- 不同编译器（pdflatex/xelatex/lualatex）的错误信息有差异
方案对比
| 维度 | LaTeX Agent | 其他方案 |
|---|---|---|
| 错误定位 | AI 自动分析错误位置和原因 | 手动阅读编译日志，逐行定位 |
| 修复建议 | 给出具体修复代码，一键应用 | 需要自行搜索解决方案 |
| 常见错误库 | 内置常见错误模式和修复方案 | 依赖社区和 Stack Overflow |
| 预防机制 | 编辑时实时检测潜在问题 | 只能在编译后发现错误 |
常见问题
! Undefined control sequence 怎么办？
这个错误表示 LaTeX 遇到了不认识的命令。最常见的原因是：命令拼写错误、忘记加载对应的宏包（比如用了 \cite 但没加载 natbib/biblatex）、或者在导言区之外定义了命令。
! Missing $ inserted 怎么办？
这通常表示你在数学公式中使用了需要数学模式的符号（如 _、^、\alpha 等），但没有用 $ 或 \[ \] 包裹。检查相关位置，确保下标、上标和希腊字母在数学环境中。
编译成功但参考文献显示不出来？
参考文献需要运行两次编译（第一次生成 .aux 文件，第二次解析引用）。另外检查 .bib 文件路径是否正确、\bibliography 命令的文件名是否不带 .bib 后缀、以及是否运行了 bibtex/biber。
相关内容
在线 LaTeX 编辑器怎么选
选择在线 LaTeX 编辑器需要综合考虑实时编译能力、AI 辅助写作、多人协作、中文支持和部署方式。如果你主要写中文学术论文且需要 AI 辅助润色和编译错误修复，LaTeX Agent 是更贴合中文论文工作流的选择；如果团队已有成熟的 Overleaf 协作习惯且不需要 AI 辅助，Overleaf 仍然是稳定可靠的基础选项。
BibTeX 参考文献管理
LaTeX 论文的参考文献管理通常使用 BibTeX 或 BibLaTeX。核心流程是：创建 .bib 文件存储文献信息 → 在正文中用 \cite 引用 → 用 \bibliography 指定 .bib 文件 → 运行编译和 bibtex/biber。LaTeX Agent 可以通过 AI 助手自动生成 BibTeX 条目、通过 DOI 获取文献信息，并在编辑器内直接管理参考文献。