# V3-test

**Repository Path**: lxlyyds/v3-test

## Basic Information

- **Project Name**: V3-test
- **Description**: vue3 测试代码项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-04
- **Last Updated**: 2025-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件分片上传系统

基于 Vue 3 和 Node.js 实现的文件分片上传系统，支持大文件分片上传、断点续传、进度显示等功能。

## 功能特点

- 文件分片上传：将大文件分割成多个小块进行上传，提高上传稳定性
- 断点续传：支持暂停和继续上传功能
- 上传进度显示：实时显示每个文件和整体的上传进度
- 错误处理：上传失败时提供重试机制
- 多文件上传：支持同时选择和上传多个文件

## 技术栈

### 前端
- Vue 3 (Composition API)
- Vite
- Fetch API

### 后端
- Node.js
- Express
- Multer (文件上传处理)

## 安装和运行

### 前端

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

### 后端

```bash
# 进入服务器目录
cd server

# 安装依赖
npm install

# 启动服务器
npm run dev
```

## 使用方法

1. 启动前端和后端服务
2. 打开浏览器访问前端地址（默认为 http://localhost:5173）
3. 点击"选择文件"按钮选择要上传的文件
4. 点击"上传"或"上传所有"按钮开始上传
5. 可以通过进度条查看上传进度
6. 可以使用"暂停"、"继续"、"取消"按钮控制上传过程

## API接口

| 接口名称 | 请求方法 | 请求参数 | 响应参数 | 描述 |
| ---- | ---- | ---- | ---- | ---- |
| /api/upload/chunk | POST | 分片数据、文件ID、分片索引、总分片数 | 上传结果 | 上传单个文件分片 |
| /api/upload/merge | POST | 文件ID | 合并结果 | 合并文件分片 |
| /api/upload/status | GET | 文件ID | 上传状态信息 | 获取文件上传状态 |
| /api/upload/cancel | POST | 文件ID | 取消结果 | 取消文件上传 |
| /api/files/:fileName | GET | 文件名 | 文件内容 | 获取已上传的文件 |

## 注意事项

- 确保前端和后端的服务器地址配置正确
- 大文件上传可能受到网络环境的影响
- 服务器需要足够的存储空间来存储上传的文件