# free-fs-vue

**Repository Path**: xddcode/free-fs-vue

## Basic Information

- **Project Name**: free-fs-vue
- **Description**: 基于 Vue 3 的Free-Fs现代化文件管理系统前端，支持多存储平台、完整的文件操作和优雅的用户界面。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://free-fs.top
- **GVP Project**: No

## Statistics

- **Stars**: 50
- **Forks**: 47
- **Created**: 2024-11-26
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Vue, fs

## README

<div align="center">

## ⚠️ 重要通知：本仓库已废弃

**本仓库已停止维护，最后支持版本为 v2.0.3**

🚀 **新版本前端已迁移至：[https://gitee.com/xddcode/free-fs-frontend](https://gitee.com/xddcode/free-fs-frontend)**

请前往新仓库获取最新功能和更新！

--- 

<img alt="Free FS Logo" src="https://gitee.com/xddcode/free-fs/raw/feature-vue/.images/logo.svg" width="100"/>

# Free FS

### 现代化文件管理网盘系统



一个基于 Spring Boot 3.x 的企业级文件管理网盘系统前端（Vue 3），专注于提供高性能、高可靠的文件存储和管理服务。

**当前版本：v2.0.3（最终版本）**

 <img src="https://img.shields.io/badge/Spring%20Boot-3.5.4-blue.svg" alt="Downloads">
 <img src="https://img.shields.io/badge/Vue-3.2-blue.svg" alt="Downloads">
 <img src="https://img.shields.io/badge/Status-Deprecated-red.svg" alt="Status">

[![star](https://gitee.com/dromara/free-fs/badge/star.svg?theme=dark)](https://gitee.com/dromara/free-fs/stargazers)
[![fork](https://gitee.com/dromara/free-fs/badge/fork.svg?theme=dark)](https://gitee.com/dromara/free-fs/members)
[![GitHub stars](https://img.shields.io/github/stars/dromara/free-fs?logo=github)](https://github.com/dromara/free-fs/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/dromara/free-fs?logo=github)](https://github.com/dromara/free-fs/network)
[![AUR](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg)](https://gitee.com/dromara/free-fs/blob/master/LICENSE)

[问题反馈](https://gitee.com/dromara/free-fs/issues) · [功能请求](https://gitee.com/dromara/free-fs/issues/new)

[项目文档](https://free-fs.top/)

</div>

---

## 源码地址

### 当前仓库（已废弃 - v2.0.3）

[Gitee：https://gitee.com/xddcode/free-fs-vue](https://gitee.com/xddcode/free-fs-vue)

### 新版本前端仓库（推荐）

[Gitee：https://gitee.com/xddcode/free-fs-frontend](https://gitee.com/xddcode/free-fs-frontend)

[Github：https://github.com/xddcode/free-fs-frontend](https://github.com/xddcode/free-fs-frontend)

[![Free FS/free-fs-frontend](https://gitee.com/xddcode/free-fs-frontend/widgets/widget_card.svg?colors=393222,ebdfc1,fffae5,d8ca9f,393222,a28b40)](https://gitee.com/xddcode/free-fs-frontend.git)

## 后端仓库

[Gitee：https://gitee.com/dromara/free-fs](https://gitee.com/dromara/free-fs)

[GitHub：https://github.com/dromara/free-fs](https://github.com/dromara/free-fs)

[![Free FS/free-fs](https://gitee.com/dromara/free-fs/widgets/widget_card.svg?colors=393222,ebdfc1,fffae5,d8ca9f,393222,a28b40)](https://gitee.com/dromara/free-fs.git)

---

## 快速开始

### 环境要求

- Node.js >= 18.0.0
- npm 或 pnpm 或 yarn

### 安装

```bash
# 克隆项目
git clone https://gitee.com/xddcode/free-fs-vue.git

# 进入项目目录
cd free-fs-vue

# 安装依赖
npm install 或 pnpm install 或 yarn
```

### 开发环境

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

# 访问 http://localhost:5173
```

### 构建

```bash
# 构建生产版本
npm run build

# 预览构建结果
npm run preview

# 构建并生成分析报告
npm run report
```

### 代码检查

```bash
# TypeScript 类型检查
npm run type:check

# 运行 lint-staged
npm run lint-staged

# 格式化
npx prettier --write .
```

---

## 技术栈

### 核心框架

- [Vue 3](https://vuejs.org/) - 渐进式 JavaScript 框架
- [TypeScript](https://www.typescriptlang.org/) - JavaScript 的超集
- [Vite](https://vitejs.dev/) - 下一代前端构建工具

### UI 组件库

- [Arco Design Vue](https://arco.design/) - 字节跳动开源的企业级设计系统

### 状态管理与路由

- [Vue Router](https://router.vuejs.org/) - 官方路由管理器
- [Pinia](https://pinia.vuejs.org/) - Vue 官方状态管理库

### 网络请求

- [Axios](https://axios-http.com/) - 基于 Promise 的 HTTP 客户端

### 工具库

- [Day.js](https://day.js.org/) - 轻量级日期处理库
- [VueUse](https://vueuse.org/) - Vue Composition API 工具集
- [ECharts](https://echarts.apache.org/) - 数据可视化图表库

### 开发工具

- [ESLint](https://eslint.org/) - 代码检查工具
- [Prettier](https://prettier.io/) - 代码格式化工具
- [Husky](https://typicode.github.io/husky/) - Git hooks 工具
- [Commitlint](https://commitlint.js.org/) - Git 提交信息规范

---

## 配置说明

### 环境变量

创建 `.env.development` 和 `.env.production` 文件：

```env
# API 基础路径
VITE_API_BASE_URL=http://localhost:8080

# 其他配置...
```

---

## 贡献指南

我们欢迎所有的贡献，无论是新功能、Bug 修复还是文档改进！

### 贡献步骤

1. Fork 本仓库
2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交你的改动 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启一个 Pull Request

### 代码规范

- 使用 TypeScript 编写代码
- 遵循 ESLint 和 Prettier 配置
- 提交信息遵循 [Conventional Commits](https://www.conventionalcommits.org/)
- 编写单元测试（如适用）

### Commit 规范

```
feat: 新功能
fix: 修复 Bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
perf: 性能优化
test: 测试相关
chore: 构建/工具链更新
```

---

## 问题反馈

如果你发现了 Bug 或有功能建议，请通过以下方式反馈：

- [Gitee Issues](https://gitee.com/dromara/free-fs/issues)

---

## 鸣谢

- [Vue.js](https://vuejs.org/) - 感谢 Vue 团队
- [Arco Design](https://arco.design/) - 感谢字节跳动设计团队
- 所有贡献者和使用者

---

## 联系方式

- GitHub: [@Freedom](https://github.com/xddcode)
- Gitee: [@Freedom](https://gitee.com/xddcode)
- Email: xddcodec@gmail.com
- 微信：

  **添加微信，请注明来意**

<img alt="wx.png" height="300" src="https://gitee.com/dromara/free-fs/raw/feature-vue/.images/wx.png" width="250"/>

- 微信公众号：

<img alt="wp.png" src="https://gitee.com/dromara/free-fs/raw/feature-vue/.images/mp.png"/>

---

## ❤ 捐赠

如果你认为 free-fs 项目可以为你提供帮助，或者给你带来方便和灵感，或者你认同这个项目，可以为我的付出赞助一下哦！

请给一个 ⭐️ 支持一下！

<img alt="pay.png" height="300" src="https://gitee.com/dromara/free-fs/raw/feature-vue/.images/pay.png" width="250"/>

<div align="center">

**[⬆ 回到顶部](#free-fs---现代化文件管理网盘系统)**

Made with ❤️ by [@Freedom](https://gitee.com/xddcode)

</div>