环境准备

软件要求

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

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

检查 Node.js 版本

node -v

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

安装包管理器

npm install -g pnpm

npm install -g yarn

获取代码

克隆前端项目

使用 Git 克隆前端项目代码到本地：

git clone https://gitee.com/xddcode/free-fs-frontend.git
# 或
git clone https://github.com/xddcode/free-fs-frontend.git

安装依赖

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

pnpm install

yarn install

npm install

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

环境变量配置

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

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

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

开发工具推荐

• VS Code - 推荐的代码编辑器
  • 安装插件：ESLint、Prettier、Tailwind CSS IntelliSense
• Chrome DevTools - 浏览器开发者工具
• React Developer Tools - React 开发者工具扩展