Wiley LaTeX模板编译报错如何解决？

Question

使用Wiley LaTeX模板时，常见报错为“Undefined control sequence \begin{abstract}”。该问题通常源于未正确加载Wiley文档类所需的宏包或使用了不兼容的LaTeX编译流程。此错误多发生在直接使用pdflatex编译时，而Wiley模板（如wiley-article.cls）依赖特定的格式初始化顺序。解决方法是：首先确认模板文件完整，确保使用latex→dvips→ps2pdf或推荐的lualatex编译流程；其次检查是否遗漏了\documentclass[review]{wiley-article}中的必要选项；最后避免在导言区加载与模板冲突的宏包，如natbib、geometry等，应优先使用模板内置配置。

Answer 1

1. 问题现象：LaTeX 编译时报错 “Undefined control sequence \begin{abstract}”

在使用 Wiley 官方提供的 LaTeX 模板（如 wiley-article.cls）撰写学术论文时，许多用户在执行 pdflatex 编译后会遭遇如下典型错误：

! Undefined control sequence.
l.45 \begin{abstract}

该错误提示表明 LaTeX 在解析 \begin{abstract} 时无法识别该命令，通常意味着文档类未能正确初始化或关键宏包未加载。尽管代码语法看似正确，但深层原因往往涉及编译流程、模板依赖与宏包冲突。

2. 初步排查：检查文档类与文件完整性

• 确认已下载最新版本的 Wiley LaTeX 模板包（通常包含 wiley-article.cls、示例文件及说明文档）。
• 确保主 TeX 文件中正确声明文档类：\documentclass[review]{wiley-article}。
• 检查是否存在拼写错误，例如误写为 wiley_article 或遗漏路径。
• 验证所有模板相关文件（.cls, .bst, .def 等）位于同一项目目录下。

若上述任一环节缺失，可能导致类文件未能正确加载抽象环境定义。

3. 核心机制：Wiley 模板对编译流程的特殊要求

Wiley 的 wiley-article.cls 并非为 pdflatex 直接设计，而是依赖传统 DVI 流程或现代 lualatex 引擎。其内部初始化顺序依赖于特定输出驱动链。

编译方式	是否推荐	原因分析
pdflatex	❌ 不推荐	跳过 DVI 阶段，导致某些 PS/PDF 特定宏未激活
latex → dvips → ps2pdf	✅ 推荐	符合模板原始构建逻辑，保证字体与图形兼容性
lualatex	✅ 推荐（现代首选）	原生支持 TTF/OTF 字体，兼容性好，无需额外转换

4. 深层诊断：导言区宏包冲突分析

开发者常习惯性引入通用宏包（如 geometry, natbib, hyperref），但 Wiley 模板已内置定制化配置。手动加载这些包可能破坏内部结构。

% 错误做法：显式加载冲突宏包 \usepackage{natbib} % 冲突！模板已集成引用系统 \usepackage{geometry} % 冲突！页边距由 cls 文件控制 \usepackage{hyperref} % 应避免提前加载

正确策略是移除冗余宏包，并通过文档类选项进行配置：

\documentclass[ review, superscriptaddress, authoryear, apacite % 使用模板支持的引用格式 ]{wiley-article}

5. 解决方案实施流程图

graph TD
    A[开始编译] --> B{使用 pdflatex?}
    B -- 是 --> C[切换至 lualatex 或 latex→dvips→ps2pdf]
    B -- 否 --> D[继续]
    C --> D
    D --> E[检查 documentclass 是否完整]
    E --> F{是否包含必要选项如 review?}
    F -- 否 --> G[添加正确选项]
    F -- 是 --> H[检查导言区宏包]
    H --> I[移除 natbib, geometry 等冲突包]
    I --> J[重新编译]
    J --> K[成功生成 PDF]

6. 实践建议与高级配置技巧

对于有 5 年以上经验的 IT 技术人员或科研工程师，建议采取以下工程化方法管理 Wiley LaTeX 项目：

1. 使用版本控制系统（Git）跟踪模板变更；
2. 编写 Makefile 自动化编译流程，例如：

all:
	lualatex manuscript.tex
	bibtex manuscript.aux
	lualatex manuscript.tex
	lualatex manuscript.tex

clean:
	rm -f *.aux *.log *.bbl *.blg *.out

此外，可结合 CI/CD 工具（如 GitHub Actions）实现远程自动化排版验证，提升协作效率。