下载smartadmin框架

安装 SmartAdmin 前端应用主要分为"获取源码"和"安装依赖"两个核心步骤。以下是详细的操作指南：

第一步：获取项目源码

首先，你需要通过 Git 将 SmartAdmin 的完整项目克隆到本地。打开命令行工具，执行以下命令：

git clone https://gitcode.com/lab1024/smart-admin.git
cd smart-admin

注：SmartAdmin 项目包含多个版本，前端目录主要分为 smart-admin-web-javascript（JavaScript版本）和 smart-admin-web-typescript（TypeScript版本，推荐选择）。

第二步：进入前端目录并安装依赖

进入你选择的前端项目目录，然后使用 npm 命令安装项目所需的依赖包。以 TypeScript 版本为例：

cd smart-admin-web-typescript
npm install

(如果你使用的是 JavaScript 版本，则进入 smart-admin-web-javascript 目录执行相同命令即可)

💡 常见问题与解决方案

在执行 npm install 时，如果遇到页面空白、报错或依赖安装不完整等问题，可以尝试清理缓存并重新安装：

rm -rf node_modules && npm install

第三步：配置环境变量并启动服务

依赖安装成功后，还需要进行简单的配置才能正常运行：

1. 配置 API 接口地址 ：在前端目录下创建环境配置文件，设置后端 API 地址：

   VITE_APP_API_BASE_URL=http://localhost:8080

2. 启动前端服务 ：

   npm run dev

3. 访问系统 ：启动成功后，在浏览器中访问 http://localhost:5173，即可看到 SmartAdmin 的系统登录界面。