Vue + iView + vuex + vee-validate 完整项目总结

 

部门最近的一个新项目启动，很幸运由我来主导整个前端部分的技术选型和整体架构，项目工作量很大，但是却没有足够的人手，只有三个连CSS都不太会的实习生跟着我一起做，压力山大。两个月以来，虽然遇见了很多问题，但是最终顺利的解决了，项目基本完成，果断写一篇总结，毕竟是第一个真正意义上全权自己负责的大项目 。

　　一、技术选型。

　　如果没有接触过新的知识，我可能会像之前的部门的所有项目一样，按部就班的使用Jquery + bootstrap + sea.js/require.js 进行开发，但是我说了NO。

　　首先，这次项目初步估计有近百个功能点和几十个页面，如果仍用jquery的方法，光是臃肿的dom操作代码就把人写的筋疲力尽了，而且我自己本人也是在是厌倦了重复而乏味DOM操作。所以我选择了Vue, 至于为什么不是react和anglar, 相对于他们Vue我觉得对于新手来说是很容易上手的，相对于react一些相关的技术栈，Vue对于实习生更容易掌握。使用Vue我只需要把项目共用的模块封装成共用组件，让他们去调用就可以了，这一点保证了他们很少去写CSS样式，也为项目快速的开发完成起到了一定的决定因素。

　　最终使用的技术如下：

　　基础JS框架： Vue， 基础样式和组件框架： iView ，国际化插件： vue-i18n，表单验证插件：vee-validate

　　项目打包工具：webpack + babel

　　代码规范性检查： eslint

　　二、项目过程中遇见的问题。

　　这部分其实是我写这篇博客的主要目的，好多问题，毕竟总结更多的是去记录过去遇见的问题和走过的弯路。

　　1、旧的JS代码的兼容。

　　由于项目中有一部分的代码是之前的项目组使用的seajs封装的模块，而且这部分代码内部的逻辑比较复杂，重写基本是不可能的，没时间何精力去研究，只有通过引入到我们的webpak工程中，如何把这部分代码挪过来并且很少改动就成了一个大问题。很幸运，webpack直接支持AMD或CMD的代码，我用的vue-cli初始化的项目，所以更改了一些webpack.base.config里的一些配置，但是忍让需要修改一些配置让原来js里的require能够找到原来的模块并执行。

　　新建了一个oldModuleConfig.js,

const path = require('path')

function resolve (dir) {
  return path.join(__dirname, '..', dir)
}

const oldModuleConfig = {
  'vue$': 'vue/dist/vue.esm.js',
  '@': resolve('src'),
   /* Switch EWeb */
  'oldModule1': resolve('src/oldModule1'),
  'oldModule2': resolve('src/oldModule2'),
  'oldModule3': resolve('src/oldModule3'),
  'oldModule4': resolve('src/oldModule4'),
}

module.exports = oldModuleConfig

　　然后修改了webpack.base.config.js

resolve: {
    extensions: ['.js', '.vue', '.json', '.less'],
　　/**  alias: {
      'vue$': 'vue/dist/vue.esm.js',
      '@': resolve('src')
　   } **/
    // 将原来的这部分改成这样
    alias: oldModuleConfig
  }

　　

　这样原来的module1里面如果写了require就可以直接使用了

var module2 = require('module2') //这行代码如果没有配置直接引入就找不到module2这个模块，而配置alias之后就可以运行了

　　这是本人自己想到的略low的方法,如果有高人指出可以在webpack里引入旧的seajs/requirejs代码其他方法，欢迎指出。

　　2、原有代码无法通过eslint语法检查

　　原来的代码虽然引进来了，但是却无法通过eslint的检查，这个问题我是直接选择忽视原有文件的检查，如果你是用了vue-cli构建的项目，可以修改.eslintignore

build/*.js
config/*.js
src/oldCodeFolder //旧代码的文件夹

　　3、Vue-router 页面刷新

　　如果用过vue-router的应该知道，如果点击的链接就是现在的页面，那么当前页面组件是不会刷新的，实际过程中可能希望再次点击页面是刷新一下。解决办法是使用一个中转页面bus,所有的页面跳转到这个bus.vue，然后由这个页面再调回原来的页面，这样就达到了刷新的效果。

　　

<!--
  这是一个中转的页面，本身不具有任何内容,为什么要设置这个中转页面呢？
  因为vue-router点击当前页面的链接时并不会刷新组件，为了保持再次点击刷新，
  通过设置这个bus中转页面即可实现
 -->
<template>
  <div>
  </div>
</template>
<script>
export default {
  data () {
    return {}
  },
  methods: {
    jumpToPage () {
      let path = this.$route.params.path
      if (path) {
        this.$router.replace(path)
      }
    }
  },
  mounted: function () {
    this.jumpToPage()
  }
}
</script>

　　然后router-view里传入下一个即将跳转的页面路径即可

  <router-link :to="{ name: 'bus', params: { path: nextPath }}":key="link.en"> {{ link.en }} </router-link>

　　

　　4、iView封装带分页的表格组件

　　iView提供了Table和Page两个组件，但是很蛋疼，没有提供带分页的表格组件，所以需要自己进行组合实现。这里提供示例代码，

　　

<template>
    <div class="clear">
      <Table :columns='columns' :data='showData' :ref="refLabel" :loading="loading" stripe :no-data-text="'<span class=\'no-data-text \' > <i class=\'icon-no-data\'></i> ' + $t('message.nodata')+ '</span>'"></Table>
      <Page :total='dataCount' :page-size='pageSize' :show-total='isShowTotal' :current.sync="current" class='paging' @on-change='changepage'></Page>
    </div>
</template>
<style scoped>
  .paging{
      float:right;
      margin-top:20px;
  }
</style>
<script>
export default {
  data () {
    return {
      ajaxHistoryData: [],
      // 初始化信息总条数
      dataCount: 0,
      // 每页显示多少条
      showData: [],
      current: 1
    }
  },
  props: {
    pageSize: {
      type: Number,
      default: 10
    },
    columns: {
      type: Array
    },
    isShowTotal: {
      type: Boolean,
      default: true
    },
    tableData: {
      type: Array
    },
    refLabel: {
      type: String
    },
    loading: {
      type: Boolean,
      default: false
    }
  },
  methods: {
    // 获取历史记录信息
    handleShowData () {
      if (this.tableData && this.tableData.length) {
        // 保存取到的所有数据
        this.dataCount = this.tableData.length
        // 初始化显示，小于每页显示条数，全显，大于每页显示条数，取前每页条数显示
        if (this.tableData.length < this.pageSize) {
          this.showData = this.tableData
        } else {
          this.showData = this.tableData.slice(0, this.pageSize)
        }
      } else {
        this.showData = []
        this.dataCount = 0
      }
      this.current = 1
    },
    currentChange (value) {
    },
    changepage (index) {
      var _start = (index - 1) * this.pageSize
      var _end = index * this.pageSize
      this.showData = this.tableData.slice(_start, _end)
    }
  },
  created () {
    this.handleShowData()
  },
  watch: {
    tableData (oldVal, newVal) {
      this.handleShowData()
　　　 // 表格刷新了，当前页标识需要回到第一页的位置
      this.current = 1
    }
  }
}
</script>

　　这里没有写异步获取数据的方法，所以具体使用时需要解渴自己的业务逻辑进行修改。

　　5、webpack打包体积过大，减少打包体积

　　说出来你们可能不信，我们的代码最终放在的服务器智能放下60M左右的文件，我也是很无奈，所以减少webpack打包体积就成了一个必须的问题。解决方法如下：

　　　　a、首先最直观的，将生产环境的sourceMap设为false ,这里设置完之后，打包后的文件就没有了.map文件，这一步基本减少了一大半的代码体积。

　　　　b、使用webpack-bundle-analyzer 优化你的代码

　　　　 如果vue-cli构建的项目，只需要在package.json的scripts里加入：

"analyz": "set NODE_ENV=production && set npm_config_report=true && npm run build"

　　       然后运行npm run analyz， 打包成功后浏览器会自动打开类似下面的页面，找出其中共用写入Vendors, 然后使用webpack.optimize.CommonsChunkPlugin 进行优化

　　

　　c、如果你们有CDN的话，尽量把基础代码如： vue , vue-router 放在CDN上面

　　d、tree shaking 去除无用的代码

　　6、其他

　　其实还有许多大大小小的问题，比如Vue的路由拦截，webpack多页面,DDL优化打包速度，覆盖iVIew组件，nginx代理，组件scoped样式覆盖不了iView默认样式等等许多，每一个解决完了都有满满的成就感。

　　三、项目构建问题回顾

　　1、代码初期没有架构合理，导致后期存在一些维护上的问题。

　　比如，代码引入了SASS，开始没有设置一个主题的公共文件，导致后面设计变动整体主题跟着发生了一些改变，虽然iView支持更改主题，但是自己写的一些组件由于没有共用的主题文件，导致后期修改比较麻烦。

　　2、代码没有review

　　虽然代码整体风格使用了eslint去规范了，但是其实真正开发的时候发现三个兄弟的代码很不规范，毕竟工作经验不足，包括变量的大小写，css类命名，甚至在页面里使用了Jquery等问题，一开始没有review， 后期仔细阅读他们的代码的时候才发现这些问题，然后才进行修改。其实这些问题在项目开始我就应该说明的。

　　3、其他

　　后续补充。。。

　　四、项目收获

　　整个项目在代码架构上还是获得了其他同事的认可，至少推动了部门前端向前走了一步，我算是部门第一个吃螃蟹的人，敢于把新技术果断使用到新的项目里，第一次将webpack + vue的技术栈整体运用了一遍，虽然不能说精通，但是应该也是熟练掌握了，总觉得自己平日所学没有白费，实践应用了一遍满满的收获。

　　2018 继续前行。

　　喜欢的话可以点个推荐或者关注哦！

　　注：本文出自博客园 https://home.cnblogs.com/u/mdengcc/ ，转载请注明出处。