XXX甄选
今天来带大家从0开始搭建一个vue3版本的后台管理系统。一个项目要有统一的规范，需要使用eslint+stylelint+prettier来对我们的代码质量做检测和修复，需要使用husky来做commit拦截，需要使用commitlint来统一提交规范，需要使用preinstall来统一包管理工具。
面我们就用这一套规范来初始化我们的项目，集成一个规范的模版。
一、环境准备
node环境 16.16.0
pnpm 8.9.2
编辑器 VsCode
二、搭建后台管理系统模板
2.1项目初始化
2.1.1初始化项目
本项目使用vite进行构建，vite官方中文文档参考：cn.vitejs.dev/guide/
pnpm:performant npm ，意味“高性能的 npm”。pnpm由npm/yarn衍生而来，解决了npm/yarn内部潜在的bug，极大的优化了性能，扩展了使用场景。被誉为“最先进的包管理工具”
pnpm安装指令
1npm i -g pnpm项目初始化命令:
1pnpm create vite进入到项目根目录pnpm install安装全部依赖.安装完依赖运行程序:pnpm run dev
运行完毕项目跑在http://127.0.0.1:5173/,可以访问你得项目啦
2.2项目配置
一、eslint配置
eslint中文官网:http://eslint.cn/
ESLint最初是由Nicholas C. Zakas 于2013年6月创建的开源项目。它的目标是提供一个插件化的javascript代码检测工具
首先安装eslint
1pnpm i eslint -D生成配置文件:.eslint.cjs
1npx eslint --init.eslint.cjs配置文件
1module.exports = {
2 //运行环境
3 "env": {
4 "browser": true,//浏览器端
5 "es2021": true,//es2021
6 },
7 //规则继承
8 "extends": [
9 //全部规则默认是关闭的,这个配置项开启推荐规则,推荐规则参照文档
10 //比如:函数不能重名、对象不能出现重复key
11 "eslint:recommended",
12 //vue3语法规则
13 "plugin:vue/vue3-essential",
14 //ts语法规则
15 "plugin:@typescript-eslint/recommended"
16 ],
17 //要为特定类型的文件指定处理器
18 "overrides": [
19 ],
20 //指定解析器:解析器
21 //Esprima 默认解析器
22 //Babel-ESLint babel解析器
23 //@typescript-eslint/parser ts解析器
24 "parser": "@typescript-eslint/parser",
25 //指定解析器选项
26 "parserOptions": {
27 "ecmaVersion": "latest",//校验ECMA最新版本
28 "sourceType": "module"//设置为"script"（默认），或者"module"代码在ECMAScript模块中
29 },
30 //ESLint支持使用第三方插件。在使用插件之前，您必须使用npm安装它
31 //该eslint-plugin-前缀可以从插件名称被省略
32 "plugins": [
33 "vue",
34 "@typescript-eslint"
35 ],
36 //eslint规则
37 "rules": {
38 }
39}1.1vue3环境代码校验插件
1# 让所有与prettier规则存在冲突的Eslint rules失效，并使用prettier进行代码检查
2"eslint-config-prettier": "^8.6.0",
3"eslint-plugin-import": "^2.27.5",
4"eslint-plugin-node": "^11.1.0",
5# 运行更漂亮的Eslint，使prettier规则优先级更高，Eslint优先级低
6"eslint-plugin-prettier": "^4.2.1",
7# vue.js的Eslint插件（查找vue语法错误，发现错误指令，查找违规风格指南
8"eslint-plugin-vue": "^9.9.0",
9# 该解析器允许使用Eslint校验所有babel code
10"@babel/eslint-parser": "^7.19.1",安装指令
1pnpm install -D eslint-plugin-import eslint-plugin-vue eslint-plugin-node eslint-plugin-prettier eslint-config-prettier eslint-plugin-node @babel/eslint-parser1.2修改.eslintrc.cjs配置文件
1// @see https://eslint.bootcss.com/docs/rules/
2
3module.exports = {
4 env: {
5 browser: true,
6 es2021: true,
7 node: true,
8 jest: true,
9 },
10 /* 指定如何解析语法 */
11 parser: 'vue-eslint-parser',
12 /** 优先级低于 parse 的语法解析配置 */
13 parserOptions: {
14 ecmaVersion: 'latest',
15 sourceType: 'module',
16 parser: '@typescript-eslint/parser',
17 jsxPragma: 'React',
18 ecmaFeatures: {
19 jsx: true,
20 },
21 },
22 /* 继承已有的规则 */
23 extends: [
24 'eslint:recommended',
25 'plugin:vue/vue3-essential',
26 'plugin:@typescript-eslint/recommended',
27 'plugin:prettier/recommended',
28 ],
29 plugins: ['vue', '@typescript-eslint'],
30 /*
31 * "off" 或 0 ==> 关闭规则
32 * "warn" 或 1 ==> 打开的规则作为警告（不影响代码执行）
33 * "error" 或 2 ==> 规则作为一个错误（代码不能执行，界面报错）
34 */
35 rules: {
36 // eslint（https://eslint.bootcss.com/docs/rules/）
37 'no-var': 'error', // 要求使用 let 或 const 而不是 var
38 'no-multiple-empty-lines': ['warn', { max: 1 }], // 不允许多个空行
39 'no-console': process.env.NODE_ENV === 'production' ? 'error' : 'off',
40 'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',
41 'no-unexpected-multiline': 'error', // 禁止空余的多行
42 'no-useless-escape': 'off', // 禁止不必要的转义字符
43
44 // typeScript (https://typescript-eslint.io/rules)
45 '@typescript-eslint/no-unused-vars': 'error', // 禁止定义未使用的变量
46 '@typescript-eslint/prefer-ts-expect-error': 'error', // 禁止使用 @ts-ignore
47 '@typescript-eslint/no-explicit-any': 'off', // 禁止使用 any 类型
48 '@typescript-eslint/no-non-null-assertion': 'off',
49 '@typescript-eslint/no-namespace': 'off', // 禁止使用自定义 TypeScript 模块和命名空间。
50 '@typescript-eslint/semi': 'off',
51
52 // eslint-plugin-vue (https://eslint.vuejs.org/rules/)
53 'vue/multi-word-component-names': 'off', // 要求组件名称始终为 “-” 链接的单词
54 'vue/script-setup-uses-vars': 'error', // 防止<script setup>使用的变量<template>被标记为未使用
55 'vue/no-mutating-props': 'off', // 不允许组件 prop的改变
56 'vue/attribute-hyphenation': 'off', // 对模板中的自定义组件强制执行属性命名样式
57 },
58}1.3.eslintignore忽略文件
1dist
2node_modules1.4运行脚本
package.json新增两个运行脚本
1"scripts": {
2 "lint": "eslint src",
3 "fix": "eslint src --fix",
4}二、配置prettier
有了eslint，为什么还要有prettier？eslint针对的是javascript，他是一个检测工具，包含js语法以及少部分格式问题，在eslint看来，语法对了就能保证代码正常运行，格式问题属于其次；
而prettier属于格式化工具，它看不惯格式不统一，所以它就把eslint没干好的事接着干，另外，prettier支持
包含js在内的多种语言。
总结起来，eslint和prettier这俩兄弟一个保证js代码质量，一个保证代码美观。
2.1安装依赖包
1pnpm install -D eslint-plugin-prettier prettier eslint-config-prettier2.2.prettierrc.json添加规则
1{
2 "singleQuote": true,
3 "semi": false,
4 "bracketSpacing": true,
5 "htmlWhitespaceSensitivity": "ignore",
6 "endOfLine": "auto",
7 "trailingComma": "all",
8 "tabWidth": 2
9}2.3.prettierignore忽略文件
1/dist/*
2/html/*
3.local
4/node_modules/**
5**/*.svg
6**/*.sh
7/public/*通过pnpm run lint去检测语法，如果出现不规范格式,通过pnpm run fix 修改
三、配置stylelint
stylelint为css的lint工具。可格式化css代码，检查css语法错误与不合理的写法，指定css书写顺序等。
我们的项目中使用scss作为预处理器，安装以下依赖：
1pnpm add sass sass-loader stylelint postcss postcss-scss postcss-html stylelint-config-prettier stylelint-config-recess-order stylelint-config-recommended-scss stylelint-config-standard stylelint-config-standard-vue stylelint-scss stylelint-order stylelint-config-standard-scss -D3.1.stylelintrc.cjs配置文件
官网:https://stylelint.bootcss.com/
1// @see https://stylelint.bootcss.com/
2
3module.exports = {
4 extends: [
5 'stylelint-config-standard', // 配置stylelint拓展插件
6 'stylelint-config-html/vue', // 配置 vue 中 template 样式格式化
7 'stylelint-config-standard-scss', // 配置stylelint scss插件
8 'stylelint-config-recommended-vue/scss', // 配置 vue 中 scss 样式格式化
9 'stylelint-config-recess-order', // 配置stylelint css属性书写顺序插件,
10 'stylelint-config-prettier', // 配置stylelint和prettier兼容
11 ],
12 overrides: [
13 {
14 files: ['**/*.(scss|css|vue|html)'],
15 customSyntax: 'postcss-scss',
16 },
17 {
18 files: ['**/*.(html|vue)'],
19 customSyntax: 'postcss-html',
20 },
21 ],
22 ignoreFiles: [
23 '**/*.js',
24 '**/*.jsx',
25 '**/*.tsx',
26 '**/*.ts',
27 '**/*.json',
28 '**/*.md',
29 '**/*.yaml',
30 ],
31 /**
32 * null => 关闭该规则
33 * always => 必须
34 */
35 rules: {
36 'value-keyword-case': null, // 在 css 中使用 v-bind，不报错
37 'no-descending-specificity': null, // 禁止在具有较高优先级的选择器后出现被其覆盖的较低优先级的选择器
38 'function-url-quotes': 'always', // 要求或禁止 URL 的引号 "always(必须加上引号)"|"never(没有引号)"
39 'no-empty-source': null, // 关闭禁止空源码
40 'selector-class-pattern': null, // 关闭强制选择器类名的格式
41 'property-no-unknown': null, // 禁止未知的属性(true 为不允许)
42 'block-opening-brace-space-before': 'always', //大括号之前必须有一个空格或不能有空白符
43 'value-no-vendor-prefix': null, // 关闭 属性值前缀 --webkit-box
44 'property-no-vendor-prefix': null, // 关闭 属性前缀 -webkit-mask
45 'selector-pseudo-class-no-unknown': [
46 // 不允许未知的选择器
47 true,
48 {
49 ignorePseudoClasses: ['global', 'v-deep', 'deep'], // 忽略属性，修改element默认样式的时候能使用到
50 },
51 ],
52 },
53}3.2.stylelintignore忽略文件
1/node_modules/*
2/dist/*
3/html/*
4/public/*3.3运行脚本
1"scripts": {
2 "lint:style": "stylelint src/**/*.{css,scss,vue} --cache --fix"
3}最后配置统一的prettier来格式化我们的js和css，html代码
1"scripts": {
2 "dev": "vite --open",
3 "build": "vue-tsc && vite build",
4 "preview": "vite preview",
5 "lint": "eslint src",
6 "fix": "eslint src --fix",
7 "format": "prettier --write \"./**/*.{html,vue,ts,js,json,md}\"",
8 "lint:eslint": "eslint src/**/*.{ts,vue} --cache --fix",
9 "lint:style": "stylelint src/**/*.{css,scss,vue} --cache --fix"
10 },当我们运行pnpm run format的时候，会把代码直接格式化
四、配置husky
在上面我们已经集成好了我们代码校验工具，但是需要每次手动的去执行命令才会格式化我们的代码。如果有人没有格式化就提交了远程仓库中，那这个规范就没什么用。所以我们需要强制让开发人员按照代码规范来提交。
要做到这件事情，就需要利用husky在代码提交之前触发git hook(git在客户端的钩子)，然后执行pnpm run format来自动的格式化我们的代码。
安装husky
1pnpm install -D husky执行
1npx husky-init会在根目录下生成个一个.husky目录，在这个目录下面会有一个pre-commit文件，这个文件里面的命令在我们执行commit的时候就会执行
在.husky/pre-commit文件添加如下命令：
1#!/usr/bin/env sh
2. "$(dirname -- "$0")/_/husky.sh"
3pnpm run format当我们对代码进行commit操作的时候，就会执行命令，对代码进行格式化，然后再提交。
五、配置commitlint
对于我们的commit信息，也是有统一规范的，不能随便写,要让每个人都按照统一的标准来执行，我们可以利用commitlint来实现。
安装包
1pnpm add @commitlint/config-conventional @commitlint/cli -D添加配置文件，新建commitlint.config.cjs(注意是cjs)，然后添加下面的代码：
1module.exports = {
2 extends: ['@commitlint/config-conventional'],
3 // 校验规则
4 rules: {
5 'type-enum': [
6 2,
7 'always',
8 [
9 'feat',
10 'fix',
11 'docs',
12 'style',
13 'refactor',
14 'perf',
15 'test',
16 'chore',
17 'revert',
18 'build',
19 ],
20 ],
21 'type-case': [0],
22 'type-empty': [0],
23 'scope-empty': [0],
24 'scope-case': [0],
25 'subject-full-stop': [0, 'never'],
26 'subject-case': [0, 'never'],
27 'header-max-length': [0, 'always', 72],
28 },
29}在package.json中配置scripts命令
1# 在scrips中添加下面的代码
2{
3"scripts": {
4 "commitlint": "commitlint --config commitlint.config.cjs -e -V"
5 },
6}配置结束，现在当我们填写commit信息的时候，前面就需要带着下面的subject
1'feat',//新特性、新功能
2'fix',//修改bug
3'docs',//文档修改
4'style',//代码格式修改, 注意不是 css 修改
5'refactor',//代码重构
6'perf',//优化相关，比如提升性能、体验
7'test',//测试用例修改
8'chore',//其他修改, 比如改变构建流程、或者增加依赖库、工具等
9'revert',//回滚到上一个版本
10'build',//编译相关的修改，例如发布版本、对项目构建或者依赖的改动配置husky
1npx husky add .husky/commit-msg在生成的commit-msg文件中添加下面的命令
1#!/usr/bin/env sh
2. "$(dirname -- "$0")/_/husky.sh"
3pnpm commitlint当我们 commit 提交信息时，就不能再随意写了，必须是 git commit -m ‘fix: xxx’ 符合类型的才可以，需要注意的是类型的后面需要用英文的 :，并且冒号后面是需要空一格的，这个是不能省略的
六、强制使用pnpm包管理器工具
团队开发项目的时候，需要统一包管理器工具,因为不同包管理器工具下载同一个依赖,可能版本不一样,
导致项目出现bug问题,因此包管理器工具需要统一管理！！！
在根目录创建scritps/preinstall.js文件，添加下面的内容
1if (!/pnpm/.test(process.env.npm_execpath || '')) {
2 console.warn(
3 `\u001b[33mThis repository must using pnpm as the package manager ` +
4 ` for scripts to work properly.\u001b[39m\n`,
5 )
6 process.exit(1)
7}配置命令
1"scripts": {
2 "preinstall": "node ./scripts/preinstall.js"
3}当我们使用npm或者yarn来安装包的时候，就会报错了。原理就是在install的时候会触发preinstall（npm提供的生命周期钩子）这个文件里面的代码。
三、项目集成
3.1集成element-plus
硅谷甄选运营平台,UI组件库采用的element-plus，因此需要集成element-plus插件！！！
官网地址:https://element-plus.gitee.io/zh-CN/
1pnpm install element-plus @element-plus/icons-vue入口文件main.ts全局安装element-plus,element-plus默认支持语言英语设置为中文
1import ElementPlus from 'element-plus';
2import 'element-plus/dist/index.css'
3//@ts-ignore忽略当前文件ts类型的检测否则有红色提示(打包会失败)
4import zhCn from 'element-plus/dist/locale/zh-cn.mjs'
5app.use(ElementPlus, {
6 locale: zhCn
7})Element Plus全局组件类型声明
1// tsconfig.json
2{
3 "compilerOptions": {
4 // ...
5 "types": ["element-plus/global"]
6 }
7}配置完毕可以测试element-plus组件与图标的使用.
3.2src别名的配置
在开发项目的时候文件与文件关系可能很复杂，因此我们需要给src文件夹配置一个别名！！！
1// vite.config.ts
2import {defineConfig} from 'vite'
3import vue from '@vitejs/plugin-vue'
4import path from 'path'
5export default defineConfig({
6 plugins: [vue()],
7 resolve: {
8 alias: {
9 "@": path.resolve("./src") // 相对路径别名配置，使用 @ 代替 src
10 }
11 }
12})TypeScript 编译配置
1// tsconfig.json
2{
3 "compilerOptions": {
4 "baseUrl": "./", // 解析非相对模块的基地址，默认是当前目录
5 "paths": { //路径映射，相对于baseUrl
6 "@/*": ["src/*"]
7 }
8 }
9}3.3环境变量的配置
项目开发过程中，至少会经历开发环境、测试环境和生产环境(即正式环境)三个阶段。不同阶段请求的状态(如接口地址等)不尽相同，若手动切换接口地址是相当繁琐且易出错的。于是环境变量配置的需求就应运而生，我们只需做简单的配置，把环境状态切换的工作交给代码。
开发环境（development）
顾名思义，开发使用的环境，每位开发人员在自己的dev分支上干活，开发到一定程度，同事会合并代码，进行联调。
测试环境（testing）
测试同事干活的环境啦，一般会由测试同事自己来部署，然后在此环境进行测试
生产环境（production）
生产环境是指正式提供对外服务的，一般会关掉错误报告，打开错误日志。(正式提供给客户使用的环境。)
注意:一般情况下，一个环境对应一台服务器,也有的公司开发与测试环境是一台服务器！！！
项目根目录分别添加 开发、生产和测试环境的文件!
1.env.development
2.env.production
3.env.test文件内容
1# 变量必须以 VITE_ 为前缀才能暴露给外部读取
2NODE_ENV = 'development'
3VITE_APP_TITLE = '硅谷甄选运营平台'
4VITE_APP_BASE_API = '/dev-api' 1NODE_ENV = 'production'
2VITE_APP_TITLE = '硅谷甄选运营平台'
3VITE_APP_BASE_API = '/prod-api' 1# 变量必须以 VITE_ 为前缀才能暴露给外部读取
2NODE_ENV = 'test'
3VITE_APP_TITLE = '硅谷甄选运营平台'
4VITE_APP_BASE_API = '/test-api'配置运行命令：package.json
1"scripts": {
2 "dev": "vite --open",
3 "build:test": "vue-tsc && vite build --mode test",
4 "build:pro": "vue-tsc && vite build --mode production",
5 "preview": "vite preview"
6 },通过import.meta.env获取环境变量
3.4SVG图标配置
在开发项目的时候经常会用到svg矢量图,而且我们使用SVG以后，页面上加载的不再是图片资源,
这对页面性能来说是个很大的提升，而且我们SVG文件比img要小的很多，放在项目中几乎不占用资源。
安装SVG依赖插件
1pnpm install vite-plugin-svg-icons -D在vite.config.ts中配置插件
1import { createSvgIconsPlugin } from 'vite-plugin-svg-icons'
2import path from 'path'
3export default () => {
4 return {
5 plugins: [
6 createSvgIconsPlugin({
7 // Specify the icon folder to be cached
8 iconDirs: [path.resolve(process.cwd(), 'src/assets/icons')],
9 // Specify symbolId format
10 symbolId: 'icon-[dir]-[name]',
11 }),
12 ],
13 }
14}入口文件导入
1import 'virtual:svg-icons-register'3.4.1svg封装为全局组件
因为项目很多模块需要使用图标,因此把它封装为全局组件！！！
在src/components目录下创建一个SvgIcon组件:代表如下
1<template>
2 <div>
3 <svg :style="{ width: width, height: height }">
4 <use :xlink:href="prefix + name" :fill="color"></use>
5 </svg>
6 </div>
7</template>
8
9<script setup lang="ts">
10defineProps({
11 //xlink:href属性值的前缀
12 prefix: {
13 type: String,
14 default: '#icon-'
15 },
16 //svg矢量图的名字
17 name: String,
18 //svg图标的颜色
19 color: {
20 type: String,
21 default: ""
22 },
23 //svg宽度
24 width: {
25 type: String,
26 default: '16px'
27 },
28 //svg高度
29 height: {
30 type: String,
31 default: '16px'
32 }
33
34})
35</script>
36<style scoped></style>在src文件夹目录下创建一个index.ts文件：用于注册components文件夹内部全部全局组件！！！
1import SvgIcon from './SvgIcon/index.vue';
2import type { App, Component } from 'vue';
3const components: { [name: string]: Component } = { SvgIcon };
4export default {
5 install(app: App) {
6 Object.keys(components).forEach((key: string) => {
7 app.component(key, components[key]);
8 })
9 }
10}在入口文件引入src/index.ts文件,通过app.use方法安装自定义插件
1import gloablComponent from './components/index';
2app.use(gloablComponent);3.5集成sass
我们目前在组件内部已经可以使用scss样式,因为在配置styleLint工具的时候，项目当中已经安装过sass sass-loader,因此我们再组件内可以使用scss语法！！！需要加上lang=“scss”
1<style scoped lang="scss"></style>接下来我们为项目添加一些全局的样式
在src/styles目录下创建一个index.scss文件，当然项目中需要用到清除默认样式，因此在index.scss引入reset.scss
1@import reset.scss在入口文件引入
1import '@/styles'但是你会发现在src/styles/index.scss全局样式文件中没有办法使用 变量 . 因此需要给项目中引入全局变量 变量.因此需要给项目中引入全局变量 变量.因此需要给项目中引入全局变量.
在style/variable.scss创建一个variable.scss文件！
在vite.config.ts文件配置如下:
1export default defineConfig((config) => {
2 css: {
3 preprocessorOptions: {
4 scss: {
5 javascriptEnabled: true,
6 additionalData: '@import "./src/styles/variable.scss";',
7 },
8 },
9 },
10 }
11}@import "./src/styles/variable.less";后面的;不要忘记，不然会报错!
配置完毕你会发现scss提供这些全局变量可以在组件样式中使用了！！！
3.6mock数据
安装依赖:https://www.npmjs.com/package/vite-plugin-mock
1pnpm install -D vite-plugin-mock mockjs在 vite.config.js 配置文件启用插件。
1import { UserConfigExport, ConfigEnv } from 'vite'
2import { viteMockServe } from 'vite-plugin-mock'
3import vue from '@vitejs/plugin-vue'
4export default ({ command })=> {
5 return {
6 plugins: [
7 vue(),
8 viteMockServe({
9 localEnabled: command === 'serve',
10 }),
11 ],
12 }
13}在根目录创建mock文件夹:去创建我们需要mock数据与接口！！！
在mock文件夹内部创建一个user.ts文件
1//用户信息数据
2function createUserList() {
3 return [
4 {
5 userId: 1,
6 avatar:
7 'https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif',
8 username: 'admin',
9 password: '111111',
10 desc: '平台管理员',
11 roles: ['平台管理员'],
12 buttons: ['cuser.detail'],
13 routes: ['home'],
14 token: 'Admin Token',
15 },
16 {
17 userId: 2,
18 avatar:
19 'https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif',
20 username: 'system',
21 password: '111111',
22 desc: '系统管理员',
23 roles: ['系统管理员'],
24 buttons: ['cuser.detail', 'cuser.user'],
25 routes: ['home'],
26 token: 'System Token',
27 },
28 ]
29}
30
31export default [
32 // 用户登录接口
33 {
34 url: '/api/user/login',//请求地址
35 method: 'post',//请求方式
36 response: ({ body }) => {
37 //获取请求体携带过来的用户名与密码
38 const { username, password } = body;
39 //调用获取用户信息函数,用于判断是否有此用户
40 const checkUser = createUserList().find(
41 (item) => item.username === username && item.password === password,
42 )
43 //没有用户返回失败信息
44 if (!checkUser) {
45 return { code: 201, data: { message: '账号或者密码不正确' } }
46 }
47 //如果有返回成功信息
48 const { token } = checkUser
49 return { code: 200, data: { token } }
50 },
51 },
52 // 获取用户信息
53 {
54 url: '/api/user/info',
55 method: 'get',
56 response: (request) => {
57 //获取请求头携带token
58 const token = request.headers.token;
59 //查看用户信息是否包含有次token用户
60 const checkUser = createUserList().find((item) => item.token === token)
61 //没有返回失败的信息
62 if (!checkUser) {
63 return { code: 201, data: { message: '获取用户信息失败' } }
64 }
65 //如果有返回成功信息
66 return { code: 200, data: {checkUser} }
67 },
68 },
69]安装axios
1pnpm install axios最后通过axios测试接口！！！
3.7axios二次封装
在开发项目的时候避免不了与后端进行交互,因此我们需要使用axios插件实现发送网络请求。在开发项目的时候
我们经常会把axios进行二次封装。
目的:
1:使用请求拦截器，可以在请求拦截器中处理一些业务(开始进度条、请求头携带公共参数)
2:使用响应拦截器，可以在响应拦截器中处理一些业务(进度条结束、简化服务器返回的数据、处理http网络错误)
在根目录下创建utils/request.ts
1import axios from "axios";
2import { ElMessage } from "element-plus";
3//创建axios实例
4let request = axios.create({
5 baseURL: import.meta.env.VITE_APP_BASE_API,
6 timeout: 5000
7})
8//请求拦截器
9request.interceptors.request.use(config => {
10 return config;
11});
12//响应拦截器
13request.interceptors.response.use((response) => {
14 return response.data;
15}, (error) => {
16 //处理网络错误
17 let msg = '';
18 let status = error.response.status;
19 switch (status) {
20 case 401:
21 msg = "token过期";
22 break;
23 case 403:
24 msg = '无权访问';
25 break;
26 case 404:
27 msg = "请求地址错误";
28 break;
29 case 500:
30 msg = "服务器出现问题";
31 break;
32 default:
33 msg = "无网络";
34
35 }
36 ElMessage({
37 type: 'error',
38 message: msg
39 })
40 return Promise.reject(error);
41});
42export default request;3.8API接口统一管理
在开发项目的时候,接口可能很多需要统一管理。在src目录下去创建api文件夹去统一管理项目的接口；
比如:下面方式
1//统一管理咱们项目用户相关的接口
2
3import request from '@/utils/request'
4
5import type {
6
7 loginFormData,
8
9 loginResponseData,
10
11 userInfoReponseData,
12
13} from './type'
14
15//项目用户相关的请求地址
16
17enum API {
18
19 LOGIN_URL = '/admin/acl/index/login',
20
21 USERINFO_URL = '/admin/acl/index/info',
22
23 LOGOUT_URL = '/admin/acl/index/logout',
24
25}
26//登录接口
27export const reqLogin = (data: loginFormData) =>
28 request.post<any, loginResponseData>(API.LOGIN_URL, data)
29//获取用户信息
30
31export const reqUserInfo = () =>
32
33 request.get<any, userInfoReponseData>(API.USERINFO_URL)
34
35//退出登录
36
37export const reqLogout = () => request.post<any, any>(API.LOGOUT_URL)