> 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/141-uploading-a-project.md).

# 上传项目

## 分步指南

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

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

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

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

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

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

![将 zip 文件上传到 Overleaf](/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://overleaf-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.