LaTeX使用中的一些坑

概述#

LaTeX是一个强大的文档排版系统，但在使用过程中可能会遇到各种问题。本文总结了LaTeX使用中的一些常见问题和解决方案。

编辑器推荐#

在线编辑器#

• 在线LaTeX公式编辑器 ↗ - 快速编辑和预览LaTeX公式
• Overleaf ↗ - 基于Web的协作LaTeX编辑器，支持实时协作

本地编辑器#

• MiKTeX ↗ - Windows平台上的LaTeX发行版，自动更新方便
• AxSoft ↗ - 付费的方程式编辑器和图表制作器

VS Code插件#

• LaTeX Workshop ↗ - VS Code的LaTeX插件，提供语法高亮、自动补全等功能
• Overleaf-Workshop ↗ - 在VS Code中打开Overleaf/ShareLaTeX项目，支持完整协作

学习资源#

• LaTeX Course ↗ - 使用Overleaf的交互式LaTeX入门教程

模板资源#

• LaTeX Templates ↗ - 收集了各种LaTeX模板，包括学位论文、演示文稿、报告、简历等
• Awesome-CV ↗ - 优秀的简历LaTeX模板

常见问题与解决方案#

1. 中文编码问题#

问题：使用CJK包时，需要GBK编码。如果导言区有中文引用（如页眉页脚的中文引用），也需要添加标签。

解决方案：

2. 公式环境和编号换行#

关于LaTeX中公式环境和编号换行的详细说明，可以参考：

• Latex中书写公式 - 知乎 ↗

3. 文件路径问题#

重要提示：LaTeX文件目录必须全英文，不能包含中文路径。

4. 编译失败问题#

问题：每次编译后可能残留辅助文件，导致后续编译失败。

解决方案：

• 每次编译前清理辅助文件（.aux, .log, .out等）
• 使用编译工具的清理功能
• 或者使用自动化构建工具（如latexmk）自动管理

5. 模板编译错误#

问题：使用模板时出现编译错误。

解决方案：

1. 检查是否安装了模板所需的所有包
2. MiKTeX会自动安装缺失的包，只需确保网络连接正常
3. 检查LaTeX发行版版本是否兼容

LaTeX编译结构#

可编译的文件类型#

• .dtx - 代码说明文档一体的结构，可编译为宏包说明文档
• .tex - 正常文档，直接编译
• .ins - 通过docstrip分解.dtx为.cls, .sty和.bbx, .cbx, .bst

参考文献相关文件#

• .bbx, .cbx, .bst - 参考文献相关样式文件，一般不包含在.dtx中，而是单独列出

编译流程#

1. XeTeX编译：先通过.ins生成模板，即生成分解.dtx后的文件
2. 使用引擎编译：之后可以使用各种配方编译文档，配方使用xelatex, lualatex等LaTeX引擎
3. 自动化构建：配方可以由自动化构建工具生成：
   • 很多工具使用build.lua
   • latexmk使用latexmkrc
   • GNU Make使用Makefile

示例模板#

• thuthesis ↗ - 清华大学学位论文LaTeX模板

Markdown嵌入LaTeX#

最佳实践#

1. 使用版本控制：使用Git等版本控制系统管理LaTeX项目
2. 定期备份：编译前备份重要文件
3. 使用模板：从可靠的模板开始，而不是从零开始
4. 保持更新：定期更新LaTeX发行版和相关包
5. 阅读文档：遇到问题时，先查阅相关包的文档

总结#

LaTeX虽然功能强大，但在使用过程中需要注意编码、路径、编译等问题。通过选择合适的编辑器、使用可靠的模板，并遵循最佳实践，可以大大提高LaTeX的使用体验。