本系列文章针对go-admin的开源项目进行解读，过程中如有问题希望大家指正，互相学习，共同进步。本文章将做成一个系列，先发布第一篇，后续陆续更新。
项目介绍
go-admin 是一个中后台管理系统，基于（gin, gorm, Casbin, Vue, Element UI）实现。主要目的是为了让开发者更专注业务，减少重复代码的编写，节省时间，提升人效，缩短项目周期，提升软件的开发效率以及质量。
image-20210210103112661下载项目
代码语言：txt复制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镜像服务
代码语言：txt复制docker pull mysql:latestdocker 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、对配置文件修改
image-20210204161223457修改第39行数据，配置正确的数据库链接字段
注意/后有一个dbname的字符串，需要先在数据库中创建好，否则会报数据库找不到的错误
代码语言：txt复制 source: root:123456@tcp(127.0.0.1:3306)/go-admin?charset=utf8&parseTime=True&loc=Local&timeout=1000ms2、进行数据库初始化迁移
首先使用go build 编译程序，得到可执行程序后再进行指令
代码语言：txt复制go-admin migrate -c config/settings.yml
image-20210204162615632看到这样的内容代表数据库初始化成功
<img src="https://gitee.com/happlyfox/img/raw/master/image-20210204162636575.png" alt="image-20210204162636575" style="zoom: 80%;" />
验证程序正确性
代码语言：txt复制go-admin server -c config/settings.yml当看到控制台出现success的内容，即代表项目启动成功
Vue前台项目启动
vue项目启动就非常简单了，有一点开发经验的同学都知道 固定的操作步骤。
首先cd到go-admin-ui目录下
依次执行
代码语言：txt复制npm install
npm run dev即可在控制台看到对应的地址，ctrl 左击即可打开
官方文档
详细的教程请查看官方文档
文档地址 https://doc.zhangwj.com/
