我的Vuejs进阶之旅(二)：Vue项目简介

本章节主要简要介绍Vue项目结构，Vue项目启动过程及原理，常用配置文件，常见问题及解决方法等内容。

1.1  Vue项目结构

应用脚手架vue-cli创建Vue项目，生成的目录结构如下：

• build目录中主要包含如下文件：

              -build.js 生产环境构建脚本

             -utils.js 构建相关工具方法

             -webpack.base.conf.js webpack基础配置

             -webpack.dev.conf.js webpack开发环境配置

             -webpack.prod.conf.js 生产环境配置

• confg 项目配置

            --dev.env.js 开发环境变量

           --index.js 项目配置文件

           --prod.env.js 生产环境变量

           --test.env.js 测试环境变量

• package.json npm包配置文件，里面定义了项目的npm脚本，依赖包等信息。
• static 静态资源存放处。
• src 源码目录

            --assets 静态资源文件存放处

            --main.js 入口js文件

            --App.vue 根组件

            --components 公共组件目录

           --router 路由配置文件

            --views 视图存放处

1.2  Vue项目启动原理剖析

vue项目启动过程中加载文件顺序大致为: index.html → main.js → app.vue → router/index.js → components/组件。

应用脚手架vue-cli创建项目时，项目创建好后一般会有三个文件：index.html、main.js、app.vue。

1. index.html ：Vue项目中，所有.vue文件都是以单页面形式开发，所有vue组件均需通过index.html进行渲染加载。

2. main.js：Vue项目入口函数，相当于java的入口函数，控制初次启动vue项目要加载的组件。

3. App.vue：项目根组件；

4. router/index.js：路由配置文件；

5. components/组件：前端视图存放处，通过路由或组件方式加载。

1.3 配置文件讲解

以webpack.base.conf.js配置文件为例，此配置文件是vue开发环境和生产环境的wepack相关配置文件，主要用来处理各种文件的配置。

// 引入nodejs路径模块
var path = require('path')
// 引入utils工具模块，utils主要用来处理css-loader和vue-style-loader的
var utils = require('./utils')
// 引入config目录下的index.js配置文件，主要用来定义一些开发和生产环境的属性
var config = require('../config')
// vue-loader.conf配置文件是用来解决各种css文件的，定义了诸如css,less,sass之类的和样式有关的loader
var vueLoaderConfig = require('./vue-loader.conf')
// 此函数是用来返回当前目录的平行目录的路径，因为有个'..'
function resolve (dir) {
  return path.join(__dirname, '..', dir)
}

module.exports = {
  entry: {
    // 入口文件是src目录下的main.js
    app: './src/main.js'
  },
  output: {
    // 路径是config目录下的index.js中的build配置中的assetsRoot，也就是dist目录
    path: config.build.assetsRoot,
    // 文件名称这里使用默认的name也就是main
    filename: '[name].js',
    // 上线地址，也就是真正的文件引用路径，如果是production生产环境，其实这里都是 '/'
    publicPath: process.env.NODE_ENV === 'production'
      ? config.build.assetsPublicPath
      : config.dev.assetsPublicPath
  },
  resolve: {
    // resolve是webpack的内置选项，顾名思义，决定要做的事情，也就是说当使用 import "jquery"，该如何去执行这件事
    // 情就是resolve配置项要做的，import jQuery from "./additional/dist/js/jquery" 这样会很麻烦，可以起个别名简化操作
    extensions: ['.js', '.vue', '.json'], // 省略扩展名，也就是说.js,.vue,.json文件导入可以省略后缀名，这会覆盖默认的配置，所以要省略扩展名在这里一定要写上
    alias: {
      //后面的$符号指精确匹配，也就是说只能使用 import vuejs from "vue" 这样的方式导入vue.esm.js文件，不能在后面跟上 vue/vue.js
      'vue$': 'vue/dist/vue.esm.js',
      // resolve('src') 其实在这里就是项目根目录中的src目录，使用 import somejs from "@/some.js" 就可以导入指定文件，是不是很高大上
      '@': resolve('src')
    }
  },
  // module用来解析不同的模块
  module: {
    rules: [
      {
        test: /\.(js|vue)$/,
        // 也就是说，对.js和.vue文件在编译之前进行检测，检查有没有语法错误
        loader: 'eslint-loader',
        // 此选项指定enforce: 'pre'选项可以确保，eslint插件能够在编译之前检测，如果不添加此项，就要把这个配置项放到末尾，确保第一个执行
        enforce: 'pre',
        // include选项指明这些目录下的文件要被eslint-loader检测，还有一个exclude表示排除某些文件夹
        include: [resolve('src'), resolve('test')],
        // options表示传递给eslint-loader的参数
        options: {
          // formatter是参数的名称，eslint-friendly-formatter是eslint的一个报告总结插件，也就是说eslint的检测
          报告非常难看懂，这个插件就是整理这些报告方便查阅的
          formatter: require('eslint-friendly-formatter')
        }
      },
      {
        test: /\.vue$/,
        // 对vue文件使用vue-loader，该loader是vue单文件组件的实现核心，专门用来解析.vue文件的
        loader: 'vue-loader',
        // 将vueLoaderConfig当做参数传递给vue-loader,就可以解析文件中的css相关文件
        options: vueLoaderConfig
      },
      {
        test: /\.js$/,
        // 对js文件使用babel-loader转码,该插件是用来解析es6等代码
        loader: 'babel-loader',
        // 指明src和test目录下的js文件要使用该loader
        include: [resolve('src'), resolve('test')]
      },
      {
        test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
        // 对图片相关的文件使用 url-loader 插件，这个插件的作用是将一个足够小的文件生成一个64位的DataURL
        // 可能有些老铁还不知道 DataURL 是啥，当一个图片足够小，为了避免单独请求可以把图片的二进制代码变成64位的
        // DataURL，使用src加载，也就是把图片当成一串代码，避免请求，神不神奇？？
        loader: 'url-loader',
        options: {
          // 限制 10000 个字节一下的图片才使用DataURL
          limit: 10000,
          name: utils.assetsPath('img/[name].[hash:7].[ext]') // 这个函数执行结果是 /img/[name].[hash:7].[ext]
          // 不知道吧 name 设置成 /img/[name].[hash:7].[ext] 意欲何为，猜测应该是输出图片的路径或者是解析图片的路径
        }
      },
      {
        test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,
        // 字体文件处理，和上面一样
        loader: 'url-loader',
        options: {
          limit: 10000,
          name: utils.assetsPath('fonts/[name].[hash:7].[ext]')
        }
      }
    ]
  }
}

1.4 常见问题解析

问题描述：Vue项目生产环境浏览器控制台出现调试打印语句，如何才能规避此类问题的发生？

原因分析：造成以上问题的原因是在开发环境调试环节进行了console.log、console.info、alert等操作来输出内容，测试代码，在出版本库时忘记取消console、debugger语句控制台输出操作。

解决措施：在项目的build/webpack.prod.conf.js文件之中，找到UglifyJsPlugin配置，在compress中添加如下代码即可。

new UglifyJsPlugin({
  uglifyOptions: {
    compress: {
      warnings: false,
      // 打包的时候移除console、debugger
      drop_debugger: true, // 移除debugger
      drop_console: true, // 移除console
      pure_funcs: ['console.log','console.info']
    }
  },
  sourceMap: config.build.productionSourceMap,
  parallel: true
}),