一句话结论:投稿系统里的 LaTeX 报错,九成集中在编译引擎、参考文献文件、图片路径与字体宏包这四类,按「先最小化再逐项加回」的顺序排查,通常两轮内就能定位。 科通编译技术排版组经手的 LaTeX 投稿稿件中,缺少参考文献编译文件与图片路径错误两类合计占一半以上,真正由模板本身缺陷引起的不足一成。报错不等于稿件有问题,绝大多数是打包方式不对。

投稿系统的LaTeX报错,主要出在哪四类问题?

四类是编译引擎、参考文献文件、图片资源、字体与宏包,按出现频率排序正好是这个顺序。 先在本地把每一类排掉,再上传,比在投稿系统里反复试错快得多。

类别典型报错关键词真实根因
编译引擎`! LaTeX Error: File 'xxx.sty' not found`、字体未找到、`Unicode character not set up`系统用 pdflatex 编译,而模板需要 xelatex 或 lualatex
参考文献`Citation 'xxx' undefined`、`There were undefined references`、问号出现在正文只上传了源文件,没上传编译后的参考文献文件
图片资源`File 'fig1.pdf' not found`、`Cannot determine size of graphic`图片未随包上传、路径写绝对路径、扩展名大小写不一致
字体宏包`Font ... not found`、`Package fontspec Error`、中文字符乱码本地用了系统字体,投稿服务器没有安装该字体

需要先建立一个基本认知:投稿系统不是你的电脑。它只提供一套受限的编译环境,通常固定一到两个引擎、不允许联网下载宏包、不保证与你本地相同的 TeX 发行版版本。因此「本地能编译、上传就报错」是常态,不是异常。

编译引擎选错会报什么错?

最典型的表现是本地用 xelatex 正常、上传后报宏包找不到或字体缺失,因为系统默认用 pdflatex。 判断方法很直接:看报错里是否出现 `fontspec`、`unicode-math`、`xeCJK`、`ctex` 这些只有 XeLaTeX 或 LuaLaTeX 才支持的宏包名。

三种引擎的差异,作者至少要记三条:

如果模板的说明文件里写明「请使用 XeLaTeX 编译」,而投稿系统只提供 pdfLaTeX,处理顺序是:

  1. 先看系统有没有引擎选项:部分投稿系统在上传界面提供下拉选择,选对即可,这是最省事的路径。
  2. 没有选项时改模板:把字体相关设置换成 pdfLaTeX 可用的写法。中文模板要做这一步往往改动很大,此时应优先考虑向编辑部说明情况。
  3. 联系编辑部说明:邮件写清「模板要求 XeLaTeX,系统默认 pdfLaTeX,请问是否支持指定引擎或接受 PDF 直接上传」。多数期刊会给出替代方案,常见的是允许上传编译好的 PDF 加源文件包。

一个常被忽略的细节:同一份源文件在不同 TeX 发行版下报错位置可能不同。如果本地是新版发行版、系统是旧版,某些新语法会直接失败。稳妥做法是在提交前用较保守的写法,避免使用近两年才加入的语法特性。

参考文献为什么会丢,怎么彻底解决?

根因只有一个:投稿系统不运行 BibTeX,它只读取你已经编译好的参考文献文件。 所以正文里全是问号、文末参考文献列表为空,几乎都是这个原因。

正确处理路径有三条,按可靠性从高到低排:

另外三个细节容易反复踩:

如果稿件已经进入返修阶段、需要新增文献,记住一个顺序:先改 `.bib`,再本地编译,确认 `.bbl` 更新后再上传。直接改 `.bbl` 是应急手段,改完必须重新编译验证一遍,否则条目编号与正文引用会对不上。

图片格式与路径怎么设置才不报错?

三条硬规则:全部用相对路径、文件名只用英文字母数字与连字符、扩展名统一小写。 三条做到,图片类报错基本清零。

常见写法结果正确写法
`\includegraphics{D:/paper/图1.png}`系统找不到文件`\includegraphics{fig1.png}`
`\includegraphics{Fig 1.pdf}`空格导致路径截断`\includegraphics{fig1.pdf}`
`\includegraphics{fig1.PNG}`Linux 服务器区分大小写`\includegraphics{fig1.png}`
`\includegraphics{figs/fig1.pdf}` 但未建目录目录缺失要么平铺,要么把目录一起打包
`\includegraphics{fig1.eps}`引擎不支持 EPS转成 PDF 或高分辨率 PNG

几个实操要点:

还有一类隐蔽问题:图片能显示但位置错乱。这通常不是路径问题,而是浮动体参数与环境嵌套导致,例如在 `figure` 环境里又套了 `minipage` 却未设置宽度。这类问题在系统编译后生成的 PDF 里表现为图跑到页面边缘或与正文重叠,属于必须逐页核对的情况。

报错后按什么顺序排查最快?

七步定位法:降复杂度、清缓存、单文件编译、逐项加回、读日志关键词、对照模板、再上传。 顺序不要跳,跳步会浪费更多时间。

  1. 降复杂度:把稿件正文全部注释掉,只留导言区和一个 `\section`,先确认模板本身能编译。这一步能把「模板缺陷」和「你的内容问题」分开。
  2. 清缓存:删掉所有 `.aux`、`.log`、`.out`、`.toc` 临时文件后重新编译。旧缓存导致的交叉引用错乱极常见。
  3. 单文件编译:如果用了 `\include` 分章,改成单个 `.tex`。投稿系统往往不支持多文件结构。
  4. 逐项加回:按「正文段落—图片—表格—参考文献—附录」的顺序加回,每次编译一次,第一次报错的位置就是问题源。
  5. 读日志关键词:在 `.log` 里搜索 `!`(错误)、`Undefined`、`not found`、`Missing`。第一个 `!` 之后的报错可能是连锁反应,只看第一条。
  6. 对照模板:把报错行与模板示例文件逐行比对,重点看宏包加载顺序与可选参数,顺序错了也会报错。
  7. 再上传:本地确认无错后,打包上传并在系统预览里看一眼生成的 PDF,不要只看「编译成功」四个字。

补充一条经验:系统报错信息往往比你本地看到的更简短,只留一行。这时不要反复上传试错,直接把本地 `.log` 的最后 20 行读一遍,八成能找到真正的错误。上传次数过多还可能触发系统的频繁提交限制。

什么时候该放弃LaTeX改用Word?

三种情形建议直接换:模板要求与系统引擎不兼容且编辑部不给替代方案、参考文献体系过于复杂无法在系统内复现、以及截稿时间不足一天。 换不是退让,而是把时间花在能被审稿人看见的地方。

换格式时有三处最容易丢东西,务必逐项检查:

转换完成后,最稳的自检方式是把生成的 PDF 逐页看一遍:图表位置、公式编号、文献编号、页眉页脚四项过一遍,通常能抓出九成问题。这一步花二十分钟,能省掉一次格式审查退回。

对于 LaTeX 用得顺、但不确定期刊模板该怎么改的作者,比较务实的做法是先把模板与报错日志放在一起看:模板决定「必须满足什么」,日志决定「哪里没满足」。如果核心问题是稿件本身的语言与结构,排版只是表象,那么先解决语言再处理模板,返修轮次会明显减少。需要判断稿件当前处于哪个阶段时,可以把摘要与目标期刊发来做一次免费论文评估。本系列更多文章见科通编译学术知识库,投稿流程栏目覆盖从材料清单、系统报错到状态跟踪的全套操作细节。

📧 55017753@qq.com

📱 微信:扫描添加客服微信咨询

🌐 kotoon.com

常见问题

Q1:本地能编译,上传投稿系统就报错,是什么原因?

A:多为引擎不一致。系统常用 pdfLaTeX,而模板要求 XeLaTeX,先确认能否指定引擎。

Q2:正文引用全变成问号怎么办?

A:说明参考文献未编译。把本地生成的 bbl 文件与 tex、图片一起打包上传即可解决。

Q3:图片上传后系统提示找不到文件?

A:检查路径是否为相对路径、文件名是否含空格或中文、扩展名大小写是否与系统一致。

Q4:能用 bib 文件代替 bbl 文件吗?

A:不建议。多数投稿系统不运行 BibTeX,只读取已编译的 bbl,bib 仅作备份用途。

Q5:报错太多改不动,可以直接交 Word 版吗?

A:可以,前提是期刊同时提供 Word 模板。转换后须逐页核对公式、交叉引用与文献编号。