Vue项目实战之人力资源平台系统（一）框架介绍及项目环境搭建

vue-element-admin 是一个后台前端解决方案&＃xff0c;它基于 vue 和 element-ui实现
它使用了最新的前端技术栈&＃xff0c;内置了 i18 国际化解决方案&＃xff0c;动态路由&＃xff0c;权限验证&＃xff0c;提炼了典型的业务模型&＃xff0c;提供了丰富的功能组件
它可以帮助我们快速搭建企业级中后台产品原型。官网&＃xff1a; https://panjiachen.gitee.io/vue-element-admin-site/zh/作为开发人员&＃xff0c;我们主要使用它提供的基础模板&＃xff0c;包含了基本的 登录 / 鉴权 / 主页布局 的一些基础功能模板
我们可以直接在该模板上进行功能的扩展和项目的二次开发

二、项目环境搭建

2.1 nodejs环境

nodejs是当下前端工程化开发必不可少的环境, 使用nodejs的npm功能来管理依赖包查看node和npm的版本&＃xff1a;$ node -v #查看node版本
$ npm -v #查看npm版本将npm设置成国内的淘宝镜像以提高下载速度&＃xff1a;$ npm config set registry https://registry.npm.taobao.org/ #设置淘宝镜像地址
$ npm config get registry #查看镜像地址


2.2 git版本控制

git版本控制工具是目前最为流行的分布式版本管理工具,代码的提交, 检出, 日志, 都需要通过git完成查看git安装版本&＃xff1a;$ git --version #查看git安装版本


2.3 vscode编辑器

vscode编辑器是目前前端开发的编码利器&＃xff0c; 以及丰富的插件系统&＃xff0c;非常适合开发前端项目通过vscode编辑器安装插件&＃xff1a;vetur &＃43; eslint
vetur是基于单文件组件开发的支持插件, eslint是基于代码校验的插件工具除此之外, eslint需要在vscode中进行一些参数的配置&＃xff1a;{"eslint.enable": true,"eslint.run": "onType","eslint.options": {"extensions": [".js",".vue",".jsx",".tsx"]},"editor.codeActionsOnSave": {"source.fixAll.eslint": true}
}

三、拉取vue-element-admin基础模板作为项目模板

3.1 git拉取基础项目模板

$ git clone https://github.com/PanJiaChen/vue-admin-template.git hrsaas #拉取基础模板到hrsaas目录
$ npm install #定位到项目目录下执行&＃xff0c;安装依赖
$ npm run dev #启动项目
若项目能正常启动则可进行下一步


3.2 项目目录解析

通过下载基础模板&＃xff0c;我们已经得到了一个基本的开发框架&＃xff0c;下面是整个项目的目录结构&＃xff1a;

├── build # 构建相关
├── mock # 项目mock 模拟数据
├── public # 静态资源
│ │── favicon.ico # favicon图标
│ └── index.html # html模板
├── src # 源代码
│ ├── api # 所有请求
│ ├── assets # 主题 字体等静态资源
│ ├── components # 全局公用组件
│ ├── icons # 项目所有 svg icons
│ ├── layout # 全局 layout
│ ├── router # 路由
│ ├── store # 全局 store管理
│ ├── styles # 全局样式
│ ├── utils # 全局公用方法
│ ├── vendor # 公用vendor
│ ├── views # views 所有页面
│ ├── App.vue # 入口页面
│ ├── main.js # 入口文件 加载组件 初始化等
│ └── permission.js # 权限管理
│ └── settings.js # 配置文件
├── tests # 测试
├── .env.xxx # 环境变量配置
├── .eslintrc.js # eslint 配置项
├── .babelrc # babel-loader 配置
├── .travis.yml # 自动化CI配置
├── vue.config.js # vue-cli 配置
├── postcss.config.js # postcss 配置
└── package.json # package.json


当我们开发项目时&＃xff0c;最关注的就是src目录, 里面是所有的源代码和资源, 至于其他目录, 都是对项目的环境和工具的配置

3.3 项目代码解析-main.js

main.js作为整个项目的入口文件&＃xff0c;它的作用如下图所示&＃xff1a;

同时&＃xff0c;main.js中还提供了模拟数据配置&＃xff0c;在我们开发时是用不到的&＃xff0c;所以要注释掉&＃xff0c;具体操作如下&＃xff1a;

注释掉main.js中mock数据的部分&＃xff0c;删除src下的mock文件夹
同时&＃xff0c;注释掉vue.config.js中的 before: require(&＃39;./mock/mock-server.js&＃39;)


3.3 项目代码解析-App.vue

App.vue作为根组件&＃xff0c;它的作用如下图所示&＃xff1a;

3.4 项目代码解析-permission.js和settings.js

permission.js 是控制页面登录权限的文件&＃xff0c;这里使用了router的导航守卫
settings.js则是对于一些项目信息的配置&＃xff0c;里面有三个属性 title(项目名称)&＃xff0c;fixedHeader&＃xff08;固定头部&＃xff09;&＃xff0c;sidebarLogo&＃xff08;显示左侧菜单logo&＃xff09;


3.5 项目代码解析-Vuex

当前项目的Vuex结构采用了模块形式进行管理共享状态&＃xff0c;其架构如下&＃xff1a;

其中app.js模块和settings.js模块&＃xff0c;功能已经完备&＃xff0c;不需要再进行修改。
user.js模块是我们后期需要重点开发的内容&＃xff0c;所以这里我们将user.js里面的内容删除&＃xff0c;并且导出一个默认配置&＃xff1a;

export default {namespaced: true,state: {},mutations: {},actions: {}
}


同时&＃xff0c;由于getters中引用了user中的状态&＃xff0c;所以我们将getters中的状态改为&＃xff1a;

const getters &＃61; {sidebar: state &＃61;> state.app.sidebar,device: state &＃61;> state.app.device
}
export default getters


3.6 项目代码解析-scss

当前项目还使用了scss作为css的扩展语言&＃xff0c;在styles目录下&＃xff0c;我们可以发现scss的相关文件&＃xff0c;结构如下&＃xff1a;

3.7 项目代码解析-icons

icons的作用是注册一个Vue组件&＃xff0c;将svg目录下的所有的.svg后缀的文件全都引入到项目中

通过目录解析我们知道&＃xff0c;API模块的作用是封装所有请求&＃xff0c;按照模块进行划分&＃xff0c;统一管理
以user.js模块为例&＃xff1a;

import request from &＃39;&＃64;/utils/request&＃39;export function login(data) {return request({url: &＃39;/vue-admin-template/user/login&＃39;,method: &＃39;post&＃39;,data})
}export function getInfo(token) {return request({url: &＃39;/vue-admin-template/user/info&＃39;,method: &＃39;get&＃39;,params: { token }})
}


上面代码中&＃xff0c;使用了封装的request工具&＃xff0c;每个接口的请求都单独导出了一个方法,这样做的好处就是,任何位置需要请求的话,可以直接引用我们导出的请求方法
为了后续更好的开发&＃xff0c;我们可以先将user.js代码的方法设置为空&＃xff0c;后续在进行更正

request工具的作用是封装axios
axios定义在utils/request.js中&＃xff0c;首先通过create创建了一个新的axios实例&＃xff0c;然后使用axios的拦截器进行开发&＃xff1a;

// 导出一个axios的实例 而且这个实例要有请求拦截器 响应拦截器
import axios from &＃39;axios&＃39;
const service &＃61; axios.create() // 创建一个axios的实例
service.interceptors.request.use() // 请求拦截器
service.interceptors.response.use() // 响应拦截器
export default service // 导出axios实例

五、建立远程Git仓库并上传项目代码

5.1 建立远程仓库

可使用Github或码云建立远程仓库

5.2 本地项目提交

$ git init #初始化项目
$ git add . #将修改添加到暂存
$ git commit -m &＃39;first commit&＃39; #将暂存提到本地仓库
$ git log #查看版本日志


5.3 推送到远程仓库

$ git remote add origin <远程仓库地址> #添加远程仓库地址
$ git remote -v #查看本地仓库的远程仓库地址映射
$ git push -u origin master #将master分支推送到origin所代表的远程仓库地址

六、公共资源图片和统一样式

项目开发用到的图片资源放置到 src/assets目录即可样式资源要放置到styles目录下&＃xff0c;然后在index.scss中引入该样式&＃64;import &＃39;./common.scss&＃39;; //引入common.scss样式表

总结

今天又开始开发新的项目&＃xff0c;这个项目利用vue-element-admin基础模板进行二次开发&＃xff0c;大大提高了开发效率