> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/161-which-file-types-should-not-be-uploaded-to-overleaf.md).

# 哪些文件类型不应上传到 Overleaf？

在将本地项目的文件打包成 .zip 文件并上传到 Overleaf（以创建新项目）之前，你需要确保这些文件/文件类型中没有任何会与 Overleaf 的 LaTeX 编译/构建过程冲突。

### 在上传你的 ZIP 文件之前……

如果上传的 .zip 文件包含一个 `main.tex` 文件和一个 `main.pdf` 文件，那么 Overleaf 项目中显示的“main.pdf”文件 *文件列表* 始终是你 *上传* 到项目中的文件——它不会更新以显示你在项目中所做的内容：也就是说，它被视为一个“输入文件”，因为它是由用户上传的。

为避免混淆，我们建议在上传前将与你本地项目的主 `.tex` 文件同名的 PDF 文件从本地项目中删除。你可以点击“重新编译”按钮旁边的“下载 PDF”按钮下载最新的 PDF，或者在左上角点击 Overleaf 菜单，然后点击“下载 PDF”。

### 在将 ZIP 文件上传到 Overleaf 之前需要删除的本地项目文件

以下文件扩展名是由编译过程生成的辅助文件，在上传到 Overleaf 之前也应从你的项目文件列表中删除：

* `*.aux` （除非你正在使用 `xr` 宏包）
* 目录、图表/表格列表：`*.toc`, `*.lof`, `*.lot`
* 参考文献和引文的辅助文件及输出文件 `*.bbl` （除非你是 *不* 使用一组 `.bib` 文件并依赖于 `.bbl` 仅此一项）， `*.bcf`, `*.blg`
* Beamer 辅助文件 `*.snm`, `*.out`, `*.nav`, `*.vrb`
* 术语表/命名法/缩略语 `*.ind`, `*.ilg`,`*.ist` （除非它是你的自定义索引样式文件）， `*.glg`,`*.gls`, `*.glo`, `*.acn`, `*.acr`, `*.alg`
* SyncTeX 文件 `*.synctex.gz`
* `latexmk` 辅助文件 文件`*.run.xml`, `*.fls`
* 各种宏包生成的其他文件扩展名。

将这些文件手动上传到你的项目列表中可能会导致构建工具出现问题，尤其是 `*.run.xml`!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/161-which-file-types-should-not-be-uploaded-to-overleaf.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
