Elsevier LaTeX投稿时图形路径错误导致编译失败

Question

在Elsevier LaTeX投稿中，图形路径错误是导致编译失败的高频问题。典型表现为：`! LaTeX Error: File 'figs/myplot.pdf' not found.` 尽管图片文件实际存在于本地项目目录，但Elsevier的官方模板（如`elsarticle.cls`）默认不加载`graphicx`宏包的`path`选项，且投稿系统（EES）使用严格沙箱环境，仅识别**相对路径下的根目录或`figures/`子目录**中的图像；若作者误用`../images/`、`./figs/`或绝对路径，或未按Elsevier要求将图文件统一置于主`.tex`同级的`figures/`文件夹并采用形如`\includegraphics{figures/myplot}`（无扩展名）的引用方式，编译即告失败。此外，Windows风格反斜杠（`\`）、空格/中文路径、大小写不匹配（如`MyPlot.PNG` vs `myplot.png`）亦常触发隐性错误。该问题在本地可编译成功，却在期刊平台报错，极具迷惑性——本质是投稿系统与本地TeX发行版路径解析机制不一致所致。

Answer 1

```html

一、现象层：编译报错的表象与迷惑性

典型错误日志：! LaTeX Error: File 'figs/myplot.pdf' not found. 该错误在本地 pdflatex 或 Overleaf 环境中常不复现，却在 Elsevier EES（Editorial Express System）投稿平台稳定触发。根本原因并非文件缺失，而是路径解析机制差异——本地 TeX 发行版（如 TeX Live）默认启用 graphics 宏包的 path 搜索机制，并兼容多种路径风格；而 EES 运行于高度受限的 Linux 沙箱容器中，仅挂载项目根目录及其直接子目录 figures/，且禁用所有宏包级路径扩展。

二、机制层：EES 沙箱环境的路径白名单策略

EES 编译器（基于 TeX Live 的定制精简镜像）执行严格路径白名单校验：

• ✅ 允许访问：./myplot.pdf（根目录）、./figures/myplot.pdf（固定子目录）
• ❌ 显式拒绝：./figs/myplot.pdf、../images/myplot.pdf、/home/user/paper/figures/myplot.pdf
• ⚠️ 隐式失败：\includegraphics{figures\myplot}（Windows 反斜杠被解析为转义符）

三、规范层：Elsevier 官方路径契约（不可协商）

根据 Elsevier LaTeX Guidelines 第 4.2 节，图像引用必须满足以下四重约束：

约束维度	合规要求	反例
目录结构	所有图文件必须置于 figures/（全小写，无空格）子目录下	Figures/, my-figures/
引用语法	\includegraphics{figures/myplot}（无扩展名，正斜杠）	\includegraphics{figures/myplot.pdf}
文件命名	全小写、ASCII 字符、无空格/中文/特殊符号	My Plot.png, 实验图1.pdf

四、诊断层：跨环境差异的自动化检测流程

为定位“本地通、EES崩”的隐性路径问题，建议执行如下诊断链（可封装为 Bash/Python 脚本）：

flowchart TD
    A[扫描主 .tex 文件] --> B{提取所有 \\includegraphics{...} }
    B --> C[标准化路径：替换 \ 为 /，移除扩展名]
    C --> D[检查是否匹配 ^figures/[^/]+$ 或 ^[^/]+\\.pdf?$]
    D --> E{是否全部落入 figures/ 或根目录？}
    E -->|否| F[报告违规路径：如 ./img/xxx]
    E -->|是| G[验证 figures/ 下真实存在对应文件]
    G --> H[检查大小写一致性 & ASCII 合法性]

五、工程层：CI/CD 友好的路径治理方案

面向 5+ 年经验的 IT/科研工程师，推荐将路径合规性纳入构建流水线：

1. 在 .gitlab-ci.yml 或 GitHub Actions 中集成 latexmk -c + 自定义校验脚本
2. 使用 Python pathlib 扫描 figures/ 目录，比对 \includegraphics 引用列表
3. 强制预处理：通过 sed -i 's/\\\\/\\//g; s/\.pdf\|\.png\|\.jpg$//' 清洗源码
4. 生成 figures/manifest.txt 记录哈希值，供 EES 编译后审计

六、防御层：模板级路径抽象与编译时注入

进阶实践：修改 elsarticle.cls（需备份），在导言区注入安全路径声明：

% 在 \documentclass{elsarticle} 后立即添加：
\makeatletter
\def\Gin@extensions{.pdf,.png,.jpg,.jpeg,}
\@addtofilelist{figures/myplot.pdf} % 预注册关键文件
\makeatother
\graphicspath{{figures/}} % 显式声明唯一合法路径

此方案绕过 EES 对 graphicx 默认配置的限制，同时保持与 Elsevier 最终 PDF 生产流程兼容。

七、认知层：从“路径错误”到“环境契约”的范式升级

资深从业者需建立新认知：LaTeX 投稿已非纯文档排版，而是交付给第三方 CI 系统的**可重现构建产物**。其本质是定义清晰的输入契约（Input Contract）——EES 不是“你的 TeX 环境”，而是“一个只认 figures/ 的 Docker 容器”。任何偏离该契约的本地便利性（如自定义 TEXINPUTS、symlink 图片目录）均属技术债。真正的鲁棒性来自契约遵从，而非环境适配。

```