# arXiv 转 LaTeX

把 arXiv 源码压缩包作为可编辑的 LaTeX 项目打开，而不必从 PDF 反向还原。

论文的源码可用时，就从源码开始。arXiv 转 LaTeX 会下载提交的源码包，识别它的主文档，并把辅助文件放在一起。这通常比转换 PDF 保留更多的结构。

## 何时使用

- 你想研究一篇 arXiv 论文是如何构建的；
- 你是作者，正在恢复或继续自己的投稿；
- 源码的许可证与你打算的用途允许复用。

只有在没有源码压缩包时，才使用 [PDF 转 LaTeX](/docs/tools/pdf-to-latex/)。如果论文的提交不包含源文件，arXiv 工具就无法打开它。要把论文转成 Typst，请使用 [arXiv 转 Typst](/docs/tools/arxiv-to-typst/)。

## 通过 ID 打开论文

1. 打开 **arXiv 转 LaTeX**，或运行 `/arxiv-to-latex`。
2. 输入形如 `1706.03762` 的标识符。包含可识别 ID 的完整 arXiv URL 也可以使用。
3. 开始下载，并等待 Oleafly 解压源码。
4. 检查检测到的主文件和源码包内容。
5. 保存 ZIP，或创建一个 LaTeX 项目。

查找 ID 会联系 arXiv，需要网络连接。如果你已经有 `.gz`、`.tgz` 或 `.tar.gz` 源码压缩包，请切换到文件输入，无需网络请求即可打开它。

## 编译之前

arXiv 源码包反映的是作者提交时的环境。它可能依赖自定义文档类、本地样式文件、字体、生成的数据或 shell 命令。

运行之前请先检查压缩包，然后先用内置的 Tectonic 编译。如果 Oleafly 发现兼容性问题，请按具体的恢复操作处理，而不要随意更换引擎。[LaTeX 引擎与宏包](/docs/latex-engines/)介绍了系统 TeX 及其信任边界。

:::caution[源码属于可执行的输入]
使用系统工具链编译时，TeX 项目可以运行外部程序。只对你信任并检查过的源码允许使用 shell 命令。
:::

转换器会保留原始文件，并报告它选作入口的文件。它不保证每一份历史提交都能在当前的 TeX 发行版上原样编译。