环境准备

软件要求

在开始运行 Free FS 前端之前，请确保你的系统已安装以下软件：

• Node.js 18.0.0 或更高版本（项目要求 >=18.0.0）
• PNPM 或 Yarn 或 NPM（推荐使用 pnpm）

检查 Node.js 版本

node -v

确保版本号 >= 18.0.0，如果版本过低，请访问 Node.js 官网 下载最新版本。

安装包管理器

PNPM（推荐）：

npm install -g pnpm

Yarn：

npm install -g yarn

安装依赖

克隆项目后，在前端根目录下运行：

使用 PNPM（推荐）：

pnpm install

使用 Yarn：

yarn install

使用 NPM：

npm install

注意：推荐使用 PNPM，因为它具有更快的安装速度和更好的磁盘空间利用。

环境变量配置

在项目根目录创建 .env.development 文件，配置开发环境的 API 地址：

# 开发环境接口前缀
VITE_API_BASE_URL='http://localhost:8080'
# 预览服务地址前缀
VITE_API_VIEW_URL='http://localhost:8080'

注意：前端所有 API 请求都使用 /apis 作为路径前缀。详细配置说明请参考 开发配置 页面。

开发工具推荐

• VS Code - 推荐的代码编辑器
  • 安装插件：Volar（Vue 3 支持）、ESLint、Prettier
• Chrome DevTools - 浏览器开发者工具
• Vue DevTools - Vue 开发者工具扩展