# 第16章：图片、视频与文件上传
附加媒体、文档、代码及其他支持的资源，为 v0 提供上下文，或将它们添加到你的应用中。
你可以向 v0 附加图片、视频、音频、文档、代码等资源，作为上下文参考，或直接加入你的应用。v0 支持直接上传文件到对话中，也支持从剪贴板复制粘贴图片。
## 上传文件
### 使用附件按钮
1. 点击聊天输入区的 + 图标，选择 Upload from computer
2. 从设备中选择一个受支持的文件
3. 文件上传后会显示在对话中
4. 在提示词中说明你希望 v0 如何使用该文件
### 拖拽上传
也可以直接把文件拖拽到聊天区域：
1. 在文件管理器中选中受支持的文件
2. 将其拖到聊天界面上方
3. 看到上传指示时松开即可
### 复制粘贴
想快速添加内容时，可以从其他应用复制图片后直接粘贴到对话中：
1. 从任意应用（浏览器、设计工具等）复制图片
2. 使用 Cmd + V（Mac）或 Ctrl + V（Windows/Linux）粘贴
## 支持的文件类型
上传服务接受以下格式：
| 类别 | 支持的格式 |
|---|
| 图片 | PNG、JPEG/JPG、WebP、GIF、SVG、ICO、AVIF |
| 视频 | MP4、WebM、OGG、MOV/QuickTime |
| 音频 | MP3/MPEG、WAV、OGG |
| 文档 | PDF、DOCX、XLSX |
| 3D 与模型资源 | GLB、glTF、OBJ |
| 文本、代码与数据 | 纯文本及其他 text/* 文件；常见代码和配置文件；JSON、TypeScript、JavaScript、YAML、SQL、XML、shell、PHP、Ruby、AWK |
| 压缩包 | ZIP、GZIP/GZ |
| 字体 | WOFF、WOFF2、TTF |
| 邮件 | EML |
| Rive 资源 | RIV |
文件是否接受主要取决于检测到的 MIME 类型。当浏览器无法报告有效的 MIME 类型时，已知的文本、代码和 Rive 扩展名会被单独处理。
DOCX 和 XLSX 文件在基于 VM 的对话中可用，v0 会在沙箱中生成并读取它们。旧版 DOC 和 XLS 格式不受支持。
## 使用场景
### 产品展示与商品目录
添加产品图片，打造丰富的电商体验：
> 构建一个商品目录页面，以响应式网格展示这些产品图片。Open in v0
### 媒体播放器与视频内容
在媒体类应用中加入视频文件：
> 创建一个视频播放器组件，用自定义控件播放这个视频。Open in v0
### 用户头像与个人资料
添加用户头像和个人资料图片：
> 构建一个用户资料页，展示这个头像，并允许用户上传自己的头像。Open in v0
### 首屏大图与横幅
把图片用在落地页和首屏区域：
> 使用这张背景图创建一个首屏区域，配上叠加文字和行动按钮。Open in v0
## 限制
文件大小限制因上传位置和订阅等级而异：
| 上传类型 | 免费用户 | Premium/Plus/Business/Enterprise 用户 |
|---|
| 聊天附件 | 5 MB | 20 MB |
| ZIP 文件上传 | 10 MB | 50 MB |
## 最佳实践
- 使用高分辨率图片（宽度至少 1024px），保证显示质量
- 对图片进行 Web 优化，确保加载速度
- 媒体搭配清晰的指令说明，效果更好
## 故障排查
如果上传文件遇到问题：
- 检查文件是否超出大小限制
- 确认文件格式受支持
- 刷新页面后重试上传
如果 v0 未能正确集成你的媒体：
- 更具体地说明你希望媒体如何展示
- 指明组件类型（画廊、播放器、背景等）
- 提供布局偏好（网格、轮播、单图展示）
善用图片和视频，你就能在 v0 中打造出体验丰富、媒体效果出众的应用。
Previous：Design Systems 2.0 Next：Versions
