Gin-Vue-Admin 安装和配置指南
1. 项目基础介绍和主要编程语言
项目介绍
Gin-Vue-Admin 是一个基于 Vue 和 Gin 开发的全栈前后端分离的开发基础平台。它集成了 JWT 鉴权、权限管理、动态路由、动态菜单、Casbin 鉴权、表单生成器、代码生成器等功能,提供多种示例文件,让您把更多时间专注在业务开发上。
主要编程语言
- 前端:Vue.js
- 后端:Go (Golang)
2. 项目使用的关键技术和框架
前端技术
- Vue 3
- Vite
- Element Plus
- Pinia (状态管理)
后端技术
- Gin (Web 框架)
- Gorm (ORM 框架)
- Casbin (权限管理)
- JWT (鉴权)
- Swagger (API 文档)
3. 项目安装和配置的准备工作和详细安装步骤
准备工作
-
安装 Node.js
确保您的系统上安装了 Node.js (版本 > v16.8.3)。您可以从 Node.js 官网 下载并安装。 -
安装 Go
确保您的系统上安装了 Go (版本 >= v1.22)。您可以从 Go 官网 下载并安装。 -
安装 Git
确保您的系统上安装了 Git。您可以从 Git 官网 下载并安装。
安装步骤
1. 克隆项目
首先,从 GitHub 克隆项目到本地:
git clone https://github.com/flipped-aurora/gin-vue-admin.git
cd gin-vue-admin
2. 安装前端依赖
进入 web
目录并安装前端依赖:
cd web
npm install
3. 启动前端项目
在 web
目录下启动前端项目:
npm run serve
4. 安装后端依赖
返回项目根目录,进入 server
目录并安装后端依赖:
cd ../server
go mod tidy
5. 生成 API 文档
在 server
目录下生成 Swagger API 文档:
swag init
6. 启动后端项目
在 server
目录下启动后端项目:
go run main.go
配置文件
项目的配置文件位于 server/config.yaml
。您可以根据需要修改配置文件中的数据库连接、JWT 密钥等信息。
访问项目
启动前后端项目后,您可以在浏览器中访问 http://localhost:8080
来查看项目。
总结
通过以上步骤,您已经成功安装并配置了 Gin-Vue-Admin 项目。您可以根据项目文档和示例文件进一步开发和定制您的应用。