别再只传PDF了Arxiv上传LaTeX源码保姆级避坑指南附Overleaf打包技巧第一次向Arxiv提交论文的研究者往往会在源码提交环节遭遇意想不到的阻碍。你可能已经精心打磨了论文内容PDF版本也反复检查无误却在提交后收到管理员邮件您的提交不完整或编译失败。这不是内容质量问题而是技术细节在作祟——Arxiv对LaTeX源码的提交有着严格而特殊的要求。作为科研交流的重要平台Arxiv要求LaTeX生成的文档必须附带完整源码这既是为了保证学术可复现性也是其自动化处理流程的技术需要。但问题在于许多研究者尤其是初次使用者并不清楚什么才算完整源码也不了解从Overleaf等在线平台获取这些文件的正确方式。更棘手的是即使你上传了所有.tex文件仍可能因为遗漏.bbl、图片路径错误或目录结构问题导致编译失败。本文将系统性地解决这些痛点从为什么必须传源码的底层逻辑到如何从Overleaf一键打包的实操技巧再到避免常见编译错误的深度解析为你提供全流程解决方案。不同于零散的注意事项罗列我们会用真实案例拆解每个环节的潜在风险让你彻底掌握Arxiv源码提交的核心要领。1. 为什么Arxiv坚持要求LaTeX源码许多研究者疑惑既然最终阅读的都是PDF为什么Arxiv不直接接受PDF上传这背后有三个关键原因学术可验证性LaTeX源码是论文的原始数据包含公式推导、参考文献原始信息等关键元素。2018年的一项研究表明超过15%的arXiv论文存在PDF与源码不一致的情况如公式编号错位、参考文献缺失这些差异只有通过源码比对才能发现。自动化处理需求Arxiv每天接收数千篇投稿其自动化系统需要源码来生成统一的页面版式提取元数据作者、机构、摘要等构建跨论文引用网络长期存档规范PDF是封闭格式而LaTeX源码作为纯文本可被未来任何系统读取支持格式转换如HTML、EPUB符合学术存档的FAIR原则可发现、可访问、可互操作、可重用表Arxiv对源码文件的具体要求文件类型是否必需典型问题.tex主文件是多文件项目遗漏次要.tex.bbl文件是误以为.bib足够图片资源是路径错误或格式不受支持.cls/.sty视情况非标准模板需完整上传其他辅助文件否测试文件可能造成干扰注意即使你的PDF在本地编译完美Arxiv的编译环境TeX Live版本、字体、依赖库可能与你的本地环境不同这就是为什么必须提供完整源码。2. Overleaf项目打包全攻略对于使用Overleaf的研究者获取完整源码包存在三个典型误区直接下载Source按钮的zip缺少.bbl仅导出主.tex文件忽略子文件依赖手动选择文件易遗漏图片或样式文件2.1 一键生成合规压缩包Overleaf其实提供了专为Arxiv设计的打包功能点击右上角「Submit」按钮选择「arXiv」图标勾选「Include compiled PDF」便于管理员比对下载生成的.zip文件这个压缩包会自动包含所有.tex文件保持原始目录结构编译好的.bbl文件图片资源自动处理路径问题必要的.cls/.sty文件2.2 手动打包的精准操作如果因特殊原因需要手动打包按以下步骤确保完整性# 在Overleaf的日志文件中查找bbl 1. 点击「日志和生成的文件」 2. 滚动到底部找到「output.bbl」或「main.bbl」 3. 下载该文件并放置在与主tex相同的目录层级 # 检查文件依赖树 4. 在主tex文件所在目录运行 pdflatex -recorder main.tex 5. 查看生成的.main.fls文件列出所有依赖项常见遗漏文件排查清单[ ] 通过\input{}或\include{}引用的子文件[ ] 参考文献的.bbl文件非.bib[ ] 所有图片.png/.jpg/.pdf[ ] 自定义的.cls/.sty模板文件[ ] 特殊字体文件如.otf提示用\graphicspath{{figures/}}命令时必须确保figures目录及其内容一并打包。3. 目录结构与路径陷阱Arxiv对文件目录结构的处理有其特殊性以下是关键注意事项3.1 目录层级限制支持一级子目录如figures/禁止多级嵌套如data/raw/images/\input{}命令可以使用但路径需相对主文件错误示例% 主文件在根目录但引用两级子目录 \input{sections/intro/background.tex} % 会导致编译失败正确做法% 将所有子文件移至一级目录 \input{sections_background.tex}3.2 图片路径最佳实践将所有图片放在figures/子目录在主文件添加路径声明\graphicspath{{figures/}}引用时省略路径前缀\includegraphics[width0.5\textwidth]{architecture.png}3.3 验证目录结构上传前用以下命令测试unzip -l submission.zip # 查看压缩包内容确保没有绝对路径如/Users/name/没有临时文件.aux, .log等所有文件在相同或一级子目录4. 参考文献与编译陷阱Arxiv的编译环境与本地有显著差异参考文献处理是最常见的失败点。4.1 BBL文件被忽视的关键为什么需要.bblArxiv禁用外部bibtex编译防止恶意代码如何获取.bbl本地编译运行pdflatex → bibtex → pdflatex完整流程Overleaf从「日志和生成的文件」下载表参考文献相关文件对比文件类型作用Arxiv要求.bib原始参考文献库不需要.bbl格式化后的参考文献必须.aux临时辅助文件禁止4.2 编译顺序验证在本地模拟Arxiv编译环境1. 删除所有中间文件.aux, .bbl, .blg 2. 仅保留.tex, .bbl, 图片 3. 运行一次pdflatex pdflatex main.tex 4. 检查PDF是否包含 - 正确编号的文献引用 - 完整的参考文献列表4.3 常见错误解决方案问题1引用显示为[?]原因缺少.bbl文件或编译不完整修复确保.bbl文件与主tex同目录问题2参考文献部分空白原因bbl文件内容损坏修复重新生成.bbl并检查是否包含\begin{thebibliography}问题3编译超时原因包含复杂tikz图形或大型表格修复将复杂元素预编译为PDF图片再引入5. 提交后的关键检查即使上传成功仍需进行以下验证等待管理员邮件通常在24小时内收到Your submission is complete成功Missing files or compilation errors需修正预览自动生成的PDF对比与本地PDF的差异公式编号是否一致图片位置是否正确参考文献格式是否变化处理版本更新如需修正使用Replace功能上传新版本注意旧版本仍会保留但标记为过时特别注意Arxiv的撤稿机制是单向且不可逆的任何提交都会永久留存于历史记录中这对专利申请可能产生重大影响。建议在涉及利保护的研究中谨慎评估提交时机。在实际操作中最容易出错的环节往往是那些看似简单的步骤——比如认为已经包含了所有文件却忽略了路径大小写敏感性Linux系统下Figure.png和figure.png被视为不同文件。一位神经科学领域的博士后曾分享他的经历因为一个图片路径的斜杠方向错误\vs/导致论文在Arxiv上显示缺失关键图表不得不紧急撤回并重新提交耽误了整整一周的公开时间。
别再只传PDF了！Arxiv上传LaTeX源码保姆级避坑指南（附Overleaf打包技巧）
发布时间：2026/6/4 13:59:58
别再只传PDF了Arxiv上传LaTeX源码保姆级避坑指南附Overleaf打包技巧第一次向Arxiv提交论文的研究者往往会在源码提交环节遭遇意想不到的阻碍。你可能已经精心打磨了论文内容PDF版本也反复检查无误却在提交后收到管理员邮件您的提交不完整或编译失败。这不是内容质量问题而是技术细节在作祟——Arxiv对LaTeX源码的提交有着严格而特殊的要求。作为科研交流的重要平台Arxiv要求LaTeX生成的文档必须附带完整源码这既是为了保证学术可复现性也是其自动化处理流程的技术需要。但问题在于许多研究者尤其是初次使用者并不清楚什么才算完整源码也不了解从Overleaf等在线平台获取这些文件的正确方式。更棘手的是即使你上传了所有.tex文件仍可能因为遗漏.bbl、图片路径错误或目录结构问题导致编译失败。本文将系统性地解决这些痛点从为什么必须传源码的底层逻辑到如何从Overleaf一键打包的实操技巧再到避免常见编译错误的深度解析为你提供全流程解决方案。不同于零散的注意事项罗列我们会用真实案例拆解每个环节的潜在风险让你彻底掌握Arxiv源码提交的核心要领。1. 为什么Arxiv坚持要求LaTeX源码许多研究者疑惑既然最终阅读的都是PDF为什么Arxiv不直接接受PDF上传这背后有三个关键原因学术可验证性LaTeX源码是论文的原始数据包含公式推导、参考文献原始信息等关键元素。2018年的一项研究表明超过15%的arXiv论文存在PDF与源码不一致的情况如公式编号错位、参考文献缺失这些差异只有通过源码比对才能发现。自动化处理需求Arxiv每天接收数千篇投稿其自动化系统需要源码来生成统一的页面版式提取元数据作者、机构、摘要等构建跨论文引用网络长期存档规范PDF是封闭格式而LaTeX源码作为纯文本可被未来任何系统读取支持格式转换如HTML、EPUB符合学术存档的FAIR原则可发现、可访问、可互操作、可重用表Arxiv对源码文件的具体要求文件类型是否必需典型问题.tex主文件是多文件项目遗漏次要.tex.bbl文件是误以为.bib足够图片资源是路径错误或格式不受支持.cls/.sty视情况非标准模板需完整上传其他辅助文件否测试文件可能造成干扰注意即使你的PDF在本地编译完美Arxiv的编译环境TeX Live版本、字体、依赖库可能与你的本地环境不同这就是为什么必须提供完整源码。2. Overleaf项目打包全攻略对于使用Overleaf的研究者获取完整源码包存在三个典型误区直接下载Source按钮的zip缺少.bbl仅导出主.tex文件忽略子文件依赖手动选择文件易遗漏图片或样式文件2.1 一键生成合规压缩包Overleaf其实提供了专为Arxiv设计的打包功能点击右上角「Submit」按钮选择「arXiv」图标勾选「Include compiled PDF」便于管理员比对下载生成的.zip文件这个压缩包会自动包含所有.tex文件保持原始目录结构编译好的.bbl文件图片资源自动处理路径问题必要的.cls/.sty文件2.2 手动打包的精准操作如果因特殊原因需要手动打包按以下步骤确保完整性# 在Overleaf的日志文件中查找bbl 1. 点击「日志和生成的文件」 2. 滚动到底部找到「output.bbl」或「main.bbl」 3. 下载该文件并放置在与主tex相同的目录层级 # 检查文件依赖树 4. 在主tex文件所在目录运行 pdflatex -recorder main.tex 5. 查看生成的.main.fls文件列出所有依赖项常见遗漏文件排查清单[ ] 通过\input{}或\include{}引用的子文件[ ] 参考文献的.bbl文件非.bib[ ] 所有图片.png/.jpg/.pdf[ ] 自定义的.cls/.sty模板文件[ ] 特殊字体文件如.otf提示用\graphicspath{{figures/}}命令时必须确保figures目录及其内容一并打包。3. 目录结构与路径陷阱Arxiv对文件目录结构的处理有其特殊性以下是关键注意事项3.1 目录层级限制支持一级子目录如figures/禁止多级嵌套如data/raw/images/\input{}命令可以使用但路径需相对主文件错误示例% 主文件在根目录但引用两级子目录 \input{sections/intro/background.tex} % 会导致编译失败正确做法% 将所有子文件移至一级目录 \input{sections_background.tex}3.2 图片路径最佳实践将所有图片放在figures/子目录在主文件添加路径声明\graphicspath{{figures/}}引用时省略路径前缀\includegraphics[width0.5\textwidth]{architecture.png}3.3 验证目录结构上传前用以下命令测试unzip -l submission.zip # 查看压缩包内容确保没有绝对路径如/Users/name/没有临时文件.aux, .log等所有文件在相同或一级子目录4. 参考文献与编译陷阱Arxiv的编译环境与本地有显著差异参考文献处理是最常见的失败点。4.1 BBL文件被忽视的关键为什么需要.bblArxiv禁用外部bibtex编译防止恶意代码如何获取.bbl本地编译运行pdflatex → bibtex → pdflatex完整流程Overleaf从「日志和生成的文件」下载表参考文献相关文件对比文件类型作用Arxiv要求.bib原始参考文献库不需要.bbl格式化后的参考文献必须.aux临时辅助文件禁止4.2 编译顺序验证在本地模拟Arxiv编译环境1. 删除所有中间文件.aux, .bbl, .blg 2. 仅保留.tex, .bbl, 图片 3. 运行一次pdflatex pdflatex main.tex 4. 检查PDF是否包含 - 正确编号的文献引用 - 完整的参考文献列表4.3 常见错误解决方案问题1引用显示为[?]原因缺少.bbl文件或编译不完整修复确保.bbl文件与主tex同目录问题2参考文献部分空白原因bbl文件内容损坏修复重新生成.bbl并检查是否包含\begin{thebibliography}问题3编译超时原因包含复杂tikz图形或大型表格修复将复杂元素预编译为PDF图片再引入5. 提交后的关键检查即使上传成功仍需进行以下验证等待管理员邮件通常在24小时内收到Your submission is complete成功Missing files or compilation errors需修正预览自动生成的PDF对比与本地PDF的差异公式编号是否一致图片位置是否正确参考文献格式是否变化处理版本更新如需修正使用Replace功能上传新版本注意旧版本仍会保留但标记为过时特别注意Arxiv的撤稿机制是单向且不可逆的任何提交都会永久留存于历史记录中这对专利申请可能产生重大影响。建议在涉及利保护的研究中谨慎评估提交时机。在实际操作中最容易出错的环节往往是那些看似简单的步骤——比如认为已经包含了所有文件却忽略了路径大小写敏感性Linux系统下Figure.png和figure.png被视为不同文件。一位神经科学领域的博士后曾分享他的经历因为一个图片路径的斜杠方向错误\vs/导致论文在Arxiv上显示缺失关键图表不得不紧急撤回并重新提交耽误了整整一周的公开时间。
