> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/141-uploading-a-project.md).

# 上传项目

## 分步指南

本文提供了一个分步指南，说明如何通过上传一个 `.zip` 包含存储在您本地计算机上的 LaTeX 文件的 .zip 文件。

1. 创建一个 `.zip` 包含您的本地文件（图片、参考文献、字体， `.tex` 源文件等）的 .zip 文件。

* 如果您的本地 LaTeX 项目使用文件夹，这些文件夹可以保留在 `.zip` .zip 文件中，并会在 `.zip` 该文件在 Overleaf 上解压时重新构建。

3. 在项目管理页面中，选择 **新建项目** 然后选择 **上传项目** 在下拉菜单中。

![在 Overleaf 上创建新项目](/files/2295a979308b5ce00656c00c7eabb824614f5d68)

6. 会显示一个窗口，您可以将您的 `.zip` 文件拖放到其中，或者选择 **选择一个 .zip 文件** 以查找一个 `.zip` 存储在您设备上的文件。

![向 Overleaf 上传 zip 文件](/files/910a77d1e9ba45c66b2beeaf68ab390ace0bd53e)

9. Overleaf 会解压上传的 `.zip` 文件，以提取文件并在您的项目中创建相应文件夹。
10. 然后您将被重定向到编辑器，新项目已创建。

* 您现在有了一个新的 Overleaf 项目，可用于编辑和重新编译。注意：如果您的 LaTeX 代码需要 LuaLaTeX 或 XeLaTeX，您可能需要 [设置项目的 LaTeX 编译器](/latex/zh-cn/zhi-shi-ku/026-changing-compiler.md).

![通过上传 .zip 文件创建的 Overleaf 项目](/files/e8d5401188f2d7e665f8d1676e0d8f2b5017f459)

## 有关文件上传的附加指南（包括限制/上限）

如果您计划上传大型项目，以下是一些您需要注意的 Overleaf 资源限制/约束：

* 您不能上传单个超过 50MB 的文件。
* 每次上传最多可包含 180 个文件——如果您尝试上传超过这个数量，只有 180 个文件会被上传。
* 每个 Overleaf 项目不能包含超过 2000 个单独文件。

如果您的项目的 `.zip` 文件超过 50MB，您可以尝试以下方法：

1. 将部分文件上传到一个 `.zip` 文件中（仅用于创建项目）。
2. 手动上传剩余文件。

对于一个 `.zip` 文件要正确上传：

* 它应只包含 LaTeX 编译器能够处理的文件类型：纯文本文件和以下格式的图片 `.eps`, `.pdf`, `.svg` 和 `.png` 。
* 它不能包含超过 7MB 的可在 Overleaf 中编辑的内容（这是 Overleaf 项目的最大可编辑数据量）。有关更多信息，请参阅页面 [免费版与付费版计划允许的最长编译时间、文件数量和项目大小是多少？](/latex/zh-cn/zhi-shi-ku/119-overleaf-plan-limits.md)

尽管 Overleaf 编辑器可以编辑任何纯文本文件，但只有上传的、带有最常见 LaTeX 文件扩展名的文件才能在该网站上编辑——例如 `.tex`, `.bib`, `.cls`, `.sty` 等。如果您需要编辑具有不同扩展名的项目文件，最好将其内容复制并粘贴到项目中的一个新的空白文件里，然后以所需的文件扩展名保存；或者，将其以上传时使用一个 `.tex` 扩展名上传，然后在联机后再更改。

超过 2MB 的文本文件无法在线编辑，也不计入 7MB 限额，这意味着，例如，您可以上传较大的 `.csv` 文件供 Rtex 使用，而不会占用您的 7MB 可编辑数据额度。


---

# 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://ayakaleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/141-uploading-a-project.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.