vue-cli脚手架build目录中的dev-server.js配置文件

本文系统讲解vue-cli脚手架build目录中的dev-server.js配置文件

1. 这个配置文件是命令npm run dev 和 npm run start 的入口配置文件，主要用于开发环境
2. 因为这是一个系统的配置文件，将涉及不少的模块和插件，因此这部份内容我将分多个文章讲解，请关注我博客的其余文章
3. 关于注释
   • 当涉及到较复杂的解释我将经过标识的方式(如（1）)将解释写到单独的注释模块，请自行查看
4. 上代码

// 导入check-versions.js文件，而且执行导入的函数，用来肯定当前环境node和npm版本是否符合要求
// 关于check-versions请查看我博客check-versions的相关文章
require('./check-versions')()
// 导入config目录下的index.js配置文件，此配置文件中定义了生产和开发环境中所要用到的一些参数
// 关于index.js的文件解释请看我博客的index.js的相关文章
var config = require('../config')
// 下面表示若是若是没有定义全局变量NODE_ENV，则将NODE_ENV设置为"development"
if (!process.env.NODE_ENV) {
    process.env.NODE_ENV = JSON.parse(config.dev.env.NODE_ENV)
}
// opn插件是用来打开特定终端的，此文件用来在默认浏览器中打开连接 opn(url)
var opn = require('opn')
// nodejs路径模块
var path = require('path')
// nodejs开发框架express，用来简化操做，有兴趣能够自行去了解
var express = require('express')
// 引入webpack模块，用来使用webpack内置插件
var webpack = require('webpack')
// 引入http-proxy-middleware插件，此插件是用来代理请求的只能用于开发环境，目的主要是解决跨域请求后台api
var proxyMiddleware = require('http-proxy-middleware')
// 下面的意思是指，若是不是testing环境就引入webpack.dev.conf.js配置文件
// 关于webpack.dev.conf.js配置文件请关注个人相关文章，建议如今就去看，不然后面看着吃力
var webpackConfig = process.env.NODE_ENV === 'testing' ?
    require('./webpack.prod.conf') :
    require('./webpack.dev.conf')

// default port where dev server listens for incoming traffic
// 下面是webpack-dev-server 监听的端口号，由于没有设置process.env.PORT，因此下面监听的就是config.dev.port即8080
var port = process.env.PORT || config.dev.port
    // automatically open browser, if not set will be false
// 下面是true,至于为啥，原本就是true还要加!!两个感叹号，估计是vue做者装了个逼吧
var autoOpenBrowser = !!config.dev.autoOpenBrowser
    // Define HTTP proxies to your custom API backend
    // https://github.com/chimurai/http-proxy-middleware
// 下面是解决开发环境跨域问题的插件，我在config目录index.js文章中有介绍，自行查看
var proxyTable = config.dev.proxyTable
// 下面是建立node.js的express开发框架的实例，别问我为何这样，本身看node.js去吧
var app = express()
// 把配置参数传递到webpack方法中，返回一个编译对象，这个编译对象上面有不少属性，本身去看吧，主要是用到里面的状态函数 如compilation，compile，after-emit这类的
var compiler = webpack(webpackConfig)
// 下面是webpack-dev-middleware和webpack-hot-middleware两兄弟，这两个是黄金组合
// 而vue做者用这两个插件也是用的最基本的形式，详情看(1) (2)
var devMiddleware = require('webpack-dev-middleware')(compiler, {
    publicPath: webpackConfig.output.publicPath,
    quiet: true  // 使用friendly-errors-webpack-plugin插件这个必须设置为true，具体看个人wepback-dev-config.js
})

var hotMiddleware = require('webpack-hot-middleware')(compiler, {
        log: () => {} // 使用friendly-errors-webpack-plugin插件这个必须设置为true，具体看个人wepback-dev-config.js
    })
    // force page reload when html-webpack-plugin template changes
compiler.plugin('compilation', function(compilation) {
    // webpack任何一个插件都plugin这个方法，里面能够传递钩子函数，用来在插件各个阶段作特殊处理，钩子函数种类不少
    compilation.plugin('html-webpack-plugin-after-emit', function(data, cb) {
        // 当插件html-webpack-plugin产出完成以后，强制刷新浏览器
        hotMiddleware.publish({ action: 'reload' })
        cb()
    })
})

// proxy api requests
Object.keys(proxyTable).forEach(function(context) {
    // 下面是代理表的处理方法，看看就好了，几乎用不上，除非你是全栈，不用webpack-dev-server，使用后台语言作服务器
    var options = proxyTable[context]
    if (typeof options === 'string') {
        options = { target: options }
    }
    app.use(proxyMiddleware(options.filter || context, options))
})

// handle fallback for HTML5 history API
// 这个插件是用来解决单页面应用，点击刷新按钮和经过其余search值定位页面的404错误
// 详情请看(3)
app.use(require('connect-history-api-fallback')())

// serve webpack bundle output
// app.use是在响应请求以前执行的，用来指定静态路径，挂载静态资源
app.use(devMiddleware)

// enable hot-reload and state-preserving
// compilation error display
app.use(hotMiddleware)

// serve pure static assets
// 下面的staticPath是 static ，path.posix.join其余配置文件中我已经介绍了，这里再也不赘述
var staticPath = path.posix.join(config.dev.assetsPublicPath, config.dev.assetsSubDirectory)
// 挂载静态资源，下面的方法是用虚拟目录来访问资源，staticPath就是虚拟目录路径，其实无论设不设置都是static
app.use(staticPath, express.static('./static'))
// 下面结果就是 'http://localhost:8080'
var uri = 'http://localhost:' + port

// 下面是es6的promise规范，用来处理嵌套请求的
var _resolve
var readyPromise = new Promise(resolve => {
    _resolve = resolve // resolve是一个回调函数专门用来传递成功请求的数据
})
// 下面是加载动画
console.log('> Starting dev server...')
// waitUntilValid是webpack-dev-middleware实例的方法，在编译成功以后调用
devMiddleware.waitUntilValid(() => {
    console.log('> Listening at ' + uri + '\n')
        // when env is testing, don't need open it
        // 测试环境不打开浏览器
    if (autoOpenBrowser && process.env.NODE_ENV !== 'testing') {
        opn(uri)
    }
    _resolve() // 这里没有传递数据，这只是在模拟
})
// node.js监听端口
var server = app.listen(port)
// 这个导出对象是用来对外提供操做服务器和接受数据的接口，vue做者可谓考虑颇深啊
module.exports = {
    ready: readyPromise, // promise实例，能够经过readyPromise.then收到数据
    close: () => {
        server.close() // 关闭服务器
    }
}

解释

(1)webpack-dev-middleware插件
   这个插件只能用于开发环境，下面是这个插件的解释
   这是一个简洁的webpack包装中间件，这个插件作这个主要为文件作一件事情，就是当文件修改后提交到webpack服务器，而后处理这些修改后的文件
   这个插件有一下几个优势
   第一，全部的文件都是写在disk上，文件的处理在内存中进行
   第二，若是文件在watch模式下被改动，这个中间件将不会为这些老的bundle服务了，若是这些老的bundle上有文件改动，
         这个中间件将不会发送请求，而是等到当前编译结束，当前最新的文件有改动，才会发送请求，因此你不须要手动刷新了
   第三，我会在之后的版本中优化
   总结，这个中间件是webpack-dev-server的核心，实现修改文件，webapack自动刷新的功能
   安装 npm install webpack-deb-middleware --save-dev
   使用方法以下，下面的使用方法也是webpack-dev-server实现的代码
   var webpackMiddleware = require("webpack-deb-middleware");
   app.use(webpackMiddleware(webpack({obj1}),{obj2}))
   app.use是express的方法，用来设置静态路径
   上面的obj1是webpack配置对象，使用webpack方法转换成compiler编译对象，obj2配置的是更新文件打包后的配置，使用
   webpackMiddleware处理以后，就返回一个静态路径，方便获取文件关于obj2的配置项，能够自行查阅，必需要添加publicPath
   说到这里，我就不卖关子了，简言之
   咱们的静态服务器是node.js，如今文件修改了，webpack-dev-middleware将修改的文件编译后，告诉nodejs服务器哪些文件修改了
   而且把最新的文件上传到静态服务器，够清楚了吧
(2)webpack-hot-middleware插件
   这个插件是用来将webpack-dev-middleware编译更新后的文件通知浏览器，而且告诉浏览器如何更新文件，从而实现 Webpack hot reloading
   将这两个插件配合起来使用你就能够不须要webpack-dev-sever，便可以本身实现hot-replacement热替换功能，
   webpack-hot-middleware插件通知浏览器更新文件大体是经过一个json对象实现的，具体实现机制这里很少说了，下面来看具体用法
   安装 npm install webpack-hot-middleware --save-dev
   在使用了webpack-dev-middleware以后，在添加以下代码便可
   app.use(require("webpack-hot-middleware")(compiler));
(3)connect-history-api-fallback插件
   由于在开发单页面应用时，总的来讲项目就一个页面，若是经过点击刷新按钮而且此时连接指的不是主页的地址，就会404；或者我经过其余的连接好比 /login.html 可是并无login.html就会报错
   而这个插件的做用就是当有不正当的操做致使404的状况，就把页面定位到默认的index.html
   使用起来也比较简单，记住这样用就能够了
   安装 npm install --save connect-history-api-fallback
   使用 var history = require('connect-history-api-fallback');
   var express = require('express');
   var app = express();
   app.use(history());