项目介绍

go-admin 是一个中后台管理系统，基于（gin, gorm, Casbin, Vue, Element UI）实现。主要目的是为了让开发者更专注业务，减少重复代码的编写，节省时间，提升人效，缩短项目周期，提升软件的开发效率以及质量。

下载项目

git clone https://github.com/go-admin-team/go-admin.git

使用git下载go-admin项目，作为一个程序员，如果说你不会使用git,那就有点说不过去了吧

本地环境准备

项目采用前后端分离的方式，后端基于golang开源组件gin搭建，前端使用vue-cli脚手架搭建。所以需要做好golang的安装和配置，npm的安装和配置，这几个步骤请参考网上，应该有很多例子，当配置完成后就可以进行本地环境的设置了。

golang环境安装

请自行google,baidu。傻瓜式安装，简单配置

npm环境安装

请自行google,baidu。傻瓜式安装，简单配置

Mysql数据库

使用Docker在本地配置Mysql镜像服务

docker pull mysql:latest

docker run -itd --name mysql-test -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql

参数说明：

• -p 3306:3306 ：映射容器服务的 3306 端口到宿主机的 3306 端口，外部主机可以直接通过 宿主机ip:3306 访问到 MySQL 的服务。
• MYSQL_ROOT_PASSWORD=123456：设置 MySQL 服务 root 用户的密码。

通过 docker ps 命令查看是否安装成功

Golang后台api服务启动

程序初始化配置

找到config文件夹，里面的内容包括了初始化数据库的sql语句和系统级别的配置文件

1、对配置文件修改

修改第39行数据，配置正确的数据库链接字段

注意/后有一个dbname的字符串，需要先在数据库中创建好，否则会报数据库找不到的错误

 source: root:123456@tcp(127.0.0.1:3306)/go-admin?charset=utf8&parseTime=True&loc=Local&timeout=1000ms

2、进行数据库初始化迁移

首先使用go build 编译程序，得到可执行程序后再进行指令

go-admin migrate -c config/settings.yml

看到这样的内容代表数据库初始化成功

验证程序正确性

go-admin server -c config/settings.yml

当看到控制台出现success的内容，即代表项目启动成功

Vue前台项目启动

vue项目启动就非常简单了，有一点开发经验的同学都知道 固定的操作步骤。

首先cd到go-admin-ui目录下

依次执行

npm install
npm run dev

即可在控制台看到对应的地址，ctrl+左击即可打开

官方文档

详细的教程请查看官方文档

文档地址https://doc.zhangwj.com/