# 上传与预览

> 把文件上传到项目的「文档和文件」，在浏览器里直接预览图片、视频、PDF、表格和代码，并在文件下评论。

最后更新：2026-11-06 · 原文：https://qunli.co/docs/uploads

## 概述

上传到「文档和文件」的每个文件都是项目里的一条记录，引用号以 F 开头。它有自己的页面：在线预览、文件信息、点赞、评论和关注都在这里。

大小上限：

| 文件类型 | 单个文件最大 |
| - | - |
| 视频 | 500MB |
| 其他文件 | 100MB |

超过上限的文件不会开始上传，上传列表里会直接显示原因。这个上限只适用于「文档和文件」；在文档、讨论或评论的正文里插入的图片和附件最大 20MB、视频最大 100MB，见[编辑器](https://qunli.co/docs/editor)。机器人通过 API 上传，每个文件最大 100MB。

## 上传文件

1. 打开项目的「文档和文件」，进入要放文件的文件夹。
2. 点击「上传文件」，选择一个或多个文件；或者直接把文件拖进页面，出现「松开鼠标，上传到…」的提示时松开。

页面右下角会出现上传列表，每个文件显示「等待上传」「上传中」（带进度）、「已完成」或「上传失败」。同时最多上传 3 个，其余排队。上传中的文件可以取消；失败的文件可以重试，也可以从列表里移除。

![页面右下角的上传列表：标题「正在上传 2/5」，下面每个文件一行，显示进度条、已完成和上传失败](https://qunli.co/docs/shots/uploads-progress-panel-light.webp)

在群历里切换到其他页面不会打断上传，但关闭或刷新浏览器标签页会中断还没传完的文件。

> **注意**：暂不支持直接上传文件夹，拖进来的文件夹会被跳过。先「新建文件夹」，进入它，再上传里面的文件。

上传完成后，文件显示在当前文件夹里，名称就是原来的文件名。之后改名（「…」菜单里的「重命名」）不影响下载：下载时用新名称，并保留原来的扩展名；文件页面上会注明「原始文件名」。

同一个文件不能上传新版本替换旧的，文件也没有[历史版本](https://qunli.co/docs/history)。有新版本时请再上传一个，在名称里注明版本。

## 预览文件

在「文档和文件」里点击一个文件，会全屏打开预览：

- 用 `←` `→` 或两侧的箭头切换同一文件夹里的其他文件，按 `Esc` 关闭。
- 点击「评论」在右侧展开这个文件的评论。
- 「全屏显示」打开这个文件自己的页面；「…」菜单里有收藏、复制链接、下载、重命名、移动和删除。

![全屏预览一张设计稿图片：顶部是文件名、评论、全屏显示和「…」，两侧是切换文件的箭头](https://qunli.co/docs/shots/uploads-lightbox-light.webp)

能在线预览的类型：

| 类型 | 预览方式 |
| - | - |
| 图片（PNG、JPEG、GIF、WebP 等） | 按原比例缩放显示 |
| 视频 | 浏览器内播放，能否播放取决于浏览器支持的编码 |
| 音频 | 浏览器内播放 |
| PDF | 逐页显示，可以翻页、缩放、「适合宽度」 |
| Markdown | 渲染成排版后的文档 |
| 代码和纯文本 | 按语言高亮，只显示前 1MB |
| CSV、TSV、Excel（.xlsx、.xlsm） | 显示为表格，每个工作表只显示前 500 行，可以切换工作表 |

Word、PowerPoint、旧版 Excel（.xls）、压缩包等暂不支持在线预览，会显示「该类型文件暂不支持在线预览，请下载后查看」和「下载」按钮。SVG 图片按源代码显示。

## 文件页面

在预览里点「全屏显示」，或在文件的「…」菜单里选「详情和评论」，打开文件自己的页面。页面上有：

- 文件名、类型、大小、上传者、更新时间，以及它所在的文件夹（点击回到那个文件夹）；
- 预览；
- 赞、评论和「关注」。关注文件的人会收到新评论的通知，详见[评论与回复](https://qunli.co/docs/comments)。

文件页面的链接以引用号结尾（如 `qunli.co/<团队>/F12`），可以贴到任务、讨论或文档里。

## 下载文件

在文件的「…」菜单、预览或文件页面里点击「下载」。文件夹不能整个下载，需要逐个下载里面的文件。

## 常见问题

### 上传失败怎么办？

先看上传列表里的原因：

- 「文件超出大小上限，无法上传」：视频最大 500MB，其他文件最大 100MB。
- 「网络连接失败，请重试」或「上传到存储服务失败，请检查网络后重试」：检查网络后点重试。
- 「登录已失效，请刷新页面后重试」：刷新页面，重新登录后再上传。

如果团队的试用或套餐已到期，团队会变为只读，也不能上传，见[套餐、试用与发票](https://qunli.co/docs/billing)。

### 为什么我的视频不能播放？

预览用浏览器自带的播放器，有些编码（例如部分 .mkv、.avi）浏览器不支持。会显示「浏览器无法播放这个视频，请下载后查看」，下载后用本地播放器打开即可。

### Word 和 PPT 能在线预览吗？

暂不支持，需要下载后打开。需要大家在线阅读和评论的内容，可以写成群历[文档](https://qunli.co/docs/drive)。

### 团队的存储空间有上限吗？

套餐页面写明了团队共享存储的容量（专业版 200GB，企业版 2TB）。目前我们不会因为存储用量阻止上传。见[套餐、试用与发票](https://qunli.co/docs/billing)。