从Overleaf到arXiv：避开LaTeX编译陷阱的实战指南-编程实验室

1. 从Overleaf到arXiv的必经之路

第一次把论文从Overleaf搬到arXiv的经历，简直像在玩扫雷游戏。明明本地编译一切正常，上传后却频频收到红色警告。最让人崩溃的是，Overleaf生成的PDF明明完美无缺，arXiv却死活不肯接受。这种情况我遇到过太多次了，后来才发现问题往往出在那些被我们忽视的"非致命警告"上。

Overleaf和arXiv虽然都使用LaTeX引擎，但运行环境存在微妙差异。Overleaf为了用户体验做了很多优化，会自动处理某些警告；而arXiv则像严格的阅卷老师，对任何不规范操作都会扣分。最常见的三类"隐形炸弹"是：缺失的宏包依赖（比如amssymb）、未正确处理的.bbl文件、以及被忽略的字体警告。这些问题的狡猾之处在于，它们不会阻止PDF生成，却能让arXiv编译失败。

2. 必须准备的"通关文件包"

2.1 文件清单检查

arXiv要求的上传包不是简单地把Overleaf项目文件夹打个压缩包就完事。经过多次踩坑，我总结出必须包含的核心文件：

主tex文件（必须与bbl文件同名）
.bbl文件（不是.bib！）
所有图片资源（建议使用相对路径）
必要的.cls和.sty文件（特别是非标准模板）

最容易遗漏的是.bbl文件，因为Overleaf不会主动显示它。获取方法很简单：在Overleaf的日志文件区域（点击右上角的"日志和输出文件"），向下滚动到"其他日志和文件"部分，就能找到生成的.bbl文件。记得下载后重命名，确保与主tex文件前缀一致。

2.2 文件结构优化

arXiv对文件路径特别敏感。建议在本地创建新文件夹，只放入必要的文件。我习惯这样组织：

paper_arxiv/ ├── main.tex ├── main.bbl ├── figures/ │ ├── fig1.pdf │ └── fig2.png └── style/ ├── IEEEtran.cls └── custom.sty

绝对要避免的坑是使用绝对路径或云端路径（比如/Users/name/或/overleaf/project/）。曾经有次我忘记修改路径，导致arXiv系统找不到图片，白白浪费了24小时等待期。

3. 那些Overleaf放过但arXiv揪住不放的警告

3.1 数学符号宏包陷阱

最经典的案例就是\mathbb命令需要的amssymb宏包。在Overleaf上，即使忘记加载这个宏包，系统会默认使用某种替代方案，可能只是显示效果不太完美。但arXiv会直接报错终止编译。类似的高危宏包还有：

amsmath（多数数学环境依赖它）
graphicx（图片插入必备）
hyperref（参考文献链接）
fontenc（T1编码防止字体问题）

检查方法很简单：在Overleaf编辑器的左侧菜单点击"日志和输出文件"，查看完整编译日志中的"警告"部分。任何以"Missing"开头的警告都要严肃对待。

3.2 字体兼容性问题

字体问题是另一个隐形杀手。有次我使用了XeLaTeX编译的字体，在arXiv上直接失败，因为arXiv默认使用pdfLaTeX。安全做法是：

在Overleaf菜单选择"编译器"为pdfLaTeX
避免使用系统字体（如Arial、Times New Roman）
使用标准LaTeX字体命令（如\textrm,\mathbf）

如果必须使用特殊字体，务必将所有字体文件（.ttf/.otf）包含在提交包中，并在tex文件头部明确定义。

4. 提交后的排错技巧

4.1 读懂arXiv的错误日志

arXiv提交后如果报错，千万别被它列出的"常见错误示例"迷惑。重点看日志开头的具体错误信息。比如这样的提示：

! LaTeX Error: File `amssymb.sty' not found.

就明确指出了缺失的宏包。而像：

! Undefined control sequence. \mathds ->\mathbb

则说明某个数学符号命令未正确定义。

4.2 本地模拟arXiv环境

最稳妥的方法是本地搭建与arXiv相似的环境测试。可以这样做：

安装基本TeX Live（不要装完整版）
只添加论文用到的宏包
使用命令行编译：

pdflatex main.tex bibtex main.aux pdflatex main.tex pdflatex main.tex

这个方法帮我发现了90%的潜在问题。特别是那些在Overleaf上被自动解决的依赖问题，在精简的本地环境中会原形毕露。

5. 高级玩家的预防性措施

5.1 预编译检查脚本

我后来养成了在Overleaf项目根目录添加check_arxiv.sh的习惯：

#!/bin/bash # 模拟arXiv编译流程 pdflatex -interaction=nonstopmode main.tex bibtex main.aux pdflatex -interaction=nonstopmode main.tex pdflatex -interaction=nonstopmode main.tex # 检查日志中的ERROR和WARNING grep -i "error\|warning" main.log > issues.txt

这个脚本会自动捕获潜在问题。在Overleaf的终端运行它，能提前发现大多数兼容性问题。