7 天开发后台系统技术小结

在确定了后台系统的详细规划和整体功能以后，花费时间更多的其实是对技术细节的打磨。本主题借鉴我开发个人网站魚立说的经验，整理了在开发后台系统过程可能会遇到的各种技术要点。

本文来源：魚立说。本文链接：https://www.yulisay.com/d/endskills.html，支持微信浏览器打开。

更多精彩文章，请移步魚立说个人网站翻看。欢迎欣赏，吐槽不足之处。

涉及到的代码已经整理到 https://github.com/yulis-say/web-full-stack 中的 end-skills 目录，若觉得有用，请分享并 star 。

1 后台开发小结

下面对后台系统的开发技术要点依次进行概括，包括必要的说明和资源引导。

1.1 后台系统模板

搭建后台系统，为了省时省力，可以选用一些流行的后台系统模板。关于这部分，可以阅读本站整理的《流行的后台管理系统模板》一文。

考虑到技术的流行性和后台功能的完善，本站使用了基于 Vue.js 和 Element-UI 实现的 vue-admin-template 作为参考，进行了后台系统的搭建和二次开发。

参考 vue-element-admin 后台系统模板，最终的后台系统效果将如图所示：

enter image description here

1.2 vue-admin-template 使用技巧

配置代理请求，解决跨域问题。做如下修改：

1  修改 .env.development 文件，VUE_APP_BASE_API 表示某个前缀：
2  VUE_APP_BASE_API = '/api'
3
4  修改 vue.config.js 文件，当遇到以 VUE_APP_BASE_API 开头的请求时，就会把 target 字段加上：
5  devServer: {
6      ……
7      proxy: {
8          [process.env.VUE_APP_BASE_API]: {
9              target: 'http://api.com',// 你自己的域名
10              secure: false,// 配置 https 接口
11              changeOrigin: true,// 是否跨域
12              pathRewrite: {
13                ['^' + process.env.VUE_APP_BASE_API]: '/api'// 替换配置中的前缀
14              }
15          }
16      }
17  }

修复 Markdown 排版样式。使用 tui.editor 作为新编辑器，请参考 https://github.com/PanJiaChen/vue-element-admin/commit/3057489cc66e17b97a77512c1e3621b96c37a4ba 修复此 bug。具体修改：

1  1. 把 package.json 文件中的 "tui-editor" 依赖替换成 "@toast-ui/editor"；
2  2. 使用参考中的 src/components/MarkdownEditor/index.vue 文件内容替代你本地的文件内容。

去除浏览器控制台输出的 async-validator 验证警告：

1  将 node_modules/async-validator 目录中的 es/util.js、lib/util.js
2  两个文件里的 console.warn(type, errors); 注释掉

在编译源码的时候，Eslint 校验失败的时候会进行一些提示：

1  Strings must use singlequote. 必须使用单引号，不能使用双引号。
2  Trailing spaces not allowed. 需要删除多余的空格。
3  Attribute ':sizeOpts' must be hyphenated. 属性有大写，需要使用"-"取代。

1.3 Vue.js 使用技巧

$nextTick() 会在下次 DOM 更新循环结束之后执行延迟回调。在修改数据之后立即使用这个方法，可以获取更新后的 DOM。
handler() 会在被侦听对象的 property 改变时被调用，不论其被嵌套多深。
computed 用来监控自定义变量，可以在页面上进行双向数据绑定展示出结果或作其他处理，比较适合对多个变量或者对象进行处理后返回一个结果值。
报错：Critical dependency: the request of a dependency is an expression. 解决：将 babel-eslint 更换至稳定版本，比如由 "^10.0.3" 更换至 7.2.3。

1.4 Element-UI 使用技巧

el-upload 上传组件，可以使用 http-request 自定义上传方法。如下代码做了简略处理：

1  <el-upload
2    ref="upload"
3    accept=".jpg, .jpeg, .png, .gif"
4    :http-request="uploadFile"
5  >
6
7  uploadFile(params) {
8    return new Promise((resolve, reject) => {
9      const formData = new FormData()
10      formData.append('file', file)
11      getImage(formData).then(response => {
12        this.tempUrl = response.data
13        resolve(true)
14      }).catch(() => {
15        reject(false)
16      })
17    })
18  }

调整 $confirm 提示框按钮位置。$confirm 提示框的按钮默认顺序是取消、确定，修改代码进行调整：

1  # CSS 调整
2  .el-btn-custom-cancel {
3    float: right;
4    margin-left: 10px;
5  }
6
7  # 设置 $confirm 按钮样式
8  this.$confirm(
9      ……
10      cancelButtonClass: 'btn-custom-cancel',
11      ……
12  }

报错：Uncaught (in promise) cancel. 因为 this.$msgbox 没有使用 .catch()，无法捕获到取消操作。可以这么写：
```
1  this.$msgbox({
2      ……
3  }).catch(error => error)
```

2 更多有用的网站

Vue.js ：一套用于构建用户界面的渐进式 JavaScript 框架，遵循 MIT 开源协议。网址：https://cn.vuejs.org/。
Element ：网站快速成型工具，一套为开发者、设计师和产品经理准备的基于 Vue 2.0 的桌面端组件库。网址：https://element.eleme.cn。
npm ：JavaScript 世界的包管理工具，并且是 Node.js 平台的默认包管理工具。通过 npm 可以安装、共享、分发代码，管理项目依赖关系。网址：https://www.npmjs.com/。
Webpack ：一个静态模块打包器(module bundler)，会递归地构建一个依赖关系图(dependency graph)，其中包含应用程序需要的每个模块，然后将所有这些模块打包成一个或多个 bundle。网址：https://www.webpackjs.com。
axios ：一个基于 promise 的 HTTP 库，可以用在浏览器和 Node.js 中。网址：http://www.axios-js.com/。

3 参考链接

① vue-element-admin 项目引导网站

② Markdown components can not preview html content · Issue #3308 · PanJiaChen/vue-element-admin

③ element $confirm 提示框按钮位置调整 - 简书