# go_admin_web

**Repository Path**: chenbool/go_admin_web

## Basic Information

- **Project Name**: go_admin_web
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-23
- **Last Updated**: 2025-10-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Go Admin Web

基于 Vue 3 + TypeScript 的管理系统前端项目

## 项目简介

这是一个使用 Vite 构建工具创建的 Vue 3 + TypeScript 管理系统前端项目，旨在提供现代化的管理界面解决方案。

## 技术栈

- [Vue 3](https://v3.vuejs.org/) - [npm](https://www.npmjs.com/package/vue)
- [TypeScript](https://www.typescriptlang.org/) - [npm](https://www.npmjs.com/package/typescript)
- [Vite](https://vitejs.dev/) - [npm](https://www.npmjs.com/package/vite)
- [Vue Router](https://router.vuejs.org/) - [npm](https://www.npmjs.com/package/vue-router)
- [Pinia](https://pinia.vuejs.org/) - [npm](https://www.npmjs.com/package/pinia)
- [pinia-plugin-persistedstate](https://github.com/prazdevs/pinia-plugin-persistedstate) - [npm](https://www.npmjs.com/package/pinia-plugin-persistedstate)
- [Element Plus](https://element-plus.org/) - [npm](https://www.npmjs.com/package/element-plus)
- [Axios](https://axios-http.com/) - [npm](https://www.npmjs.com/package/axios)
- [vite-plugin-svg-icons](https://github.com/vbenjs/vite-plugin-svg-icons) - [npm](https://www.npmjs.com/package/vite-plugin-svg-icons)

## 快速开始

### 环境要求

- Node.js >= 16.0.0
- npm >= 7.0.0

### 创建项目

```bash
npm create vite@latest go_admin_web -- --template vue-ts
```

### 安装依赖

```bash
npm install
```

### 安装 Vue Router

```bash
npm i vue-router@4
```

### 安装 Pinia

```bash
npm i pinia
```

### 安装 Pinia 持久化插件

```bash
npm i pinia-plugin-persistedstate
```

### 安装 Element Plus

```bash
npm i element-plus
```

### 安装 Axios

```bash
npm i axios
```

### 安装 NProgress 进度条

```bash
npm install nprogress --save
```

### 安装 SVG 图标插件（开发依赖）

```bash
npm i vite-plugin-svg-icons -D
```

### 安装 fast-glob 解决 SVG 插件问题

```bash
npm i fast-glob -D
```

### 开发环境运行

```bash
npm run dev
```

### 生产环境构建

```bash
npm run build
```

### 预览生产构建

```bash
npm run preview
```

## 常见问题

### vite-plugin-svg-icons 启动错误

在使用 vite-plugin-svg-icons 库时，启动项目可能出现错误。这是由于缺少 fast-glob 依赖导致的。

**解决方案：**
安装 fast-glob 依赖来解决该问题：
```bash
npm i fast-glob -D
```

## 项目结构

```
src/
├── components/      # 公共组件
├── views/           # 页面视图
├── router/          # 路由配置
├── store/           # 状态管理
├── assets/          # 静态资源
├── styles/          # 样式文件
├── utils/           # 工具函数
├── services/        # 接口服务
└── App.vue          # 根组件
```

## 开发规范

- 使用 TypeScript 进行类型检查
- 遵循 ESLint 和 Prettier 规范
- 组件命名采用 PascalCase
- 文件命名采用 kebab-case

## Vite 配置

### 路径别名

项目中配置了路径别名，方便在组件中引用文件：

```ts
// vite.config.ts
resolve: {
  alias: {
    '@': path.resolve('./src') // 用@替代src
  }
}
```

使用示例：
```ts
import HelloWorld from '@/components/HelloWorld.vue'
```

## 许可证

MIT