一份比较详细的 webpack 4.x 手工配置基础开发环境 附源码

从新书写了博客内容，但愿能够更好的呈现该有的知识点。
bundle.js 指的是 webpack 打包后的文件。

小剧场

项目经理：咱们要开始一个新的项目，裤裆你来负责项目构建吧。
我：好的没问题，经理请稍等。

npm install vue-cli -g
vue init webpack -y new-project-name
复制代码

我：好了，咱们开始吧。
项目经理：接下来呢？

我：接下来没了，能够开发了。
项目经理：裤裆啊，速度快是好事，可是我看你每次都是那么几步，能不能来点不同的，你看那些面试官，面试手写一个 webpack 4.x 的配置，你知道怎么写么？
我：。。。。。。
项目经理：（拂袖而去，远远地听到空中传来一句话）年轻人，切勿急躁，稳中求胜啊。
我：项目急的时候你不是这么说的。
项目经理：裤裆你说啥？
我：经理你说得对。

前言

在咱们在面对一个新的项目的时候，网上的大量优秀的模板可使咱们少走不少弯路，能够把主要的精力放在业务上，等到后期项目庞大了，业务复杂了的时候再去作一些优化，这其中包括项目打包速度优化，项目打包体积优化（也能够看作是首屏加载优化），等等，可是，身为一个爱折腾的程序猿，面对这些模板，是的，我很好奇！

固然，文章开始以前，附上该项目的地址，github@jsjzh，全部的代码我都加上了注释，但愿你们看完以后能够有所收获，最好能赏个 star 啦！=3=

git clone https://github.com/jsjzh/my-webpack-template.git
cd my-webpack-template
npm install
npm start
复制代码

webpack 4.x 的那些新玩意儿

在最新的 官方文档 中，有两个新的配置项，mode 和 optimization，咱们就从这两个入手，看看 webpack .4x 有什么新东西。

下面会介绍由于你配置了不一样的 mode 以后，你的代码会受到的不一样对待。

mode 是个啥

这个配置项是区分 webpack 4.x 和其余版本最方便的手段，webpack 4.x 给咱们提供了两个模式用做开发和生产的模式，这两个模式下 webpack 默默给咱们开启了很多优化手段，固然，这些优化手段咱们也是能够配置的，就是在 optimization 这个配置项中，咱们也能够本身增长 optimization 选项对项目进行更细的优化。

production | development | none
复制代码

下面我会对 mode 的两个值 production 和 development 进行比较详细的说明，看看 webpack 到底偷偷给咱们开启了什么优化。

prod 和 dev 相同的优化

mode: production || development 时，webpack 都会开启的优化。

{
  "mode": "production" || "development",
  "optimization": {
    // 若是 子模块 和 父模块 都加载了同一个 A模块 的时候，开启这个选项将会告诉 webpack 跳过在 子模块 中对 A模块 的检索，这能够加快打包速度。
    "removeAvailableModules": true,
    // webpack 将会不会去打包一个空的模块。
    "removeEmptyChunks": true,
    // 告诉 webpack 合并一些包含了相同模块的模块。
    "mergeDuplicateChunks": true,
    // 会在 process.env.NODE_ENV 中传入当前的 mode 环境。
    "nodeEnv": "production" || "development"
  }
}
复制代码

prod 和 dev 不一样的优化

mode: production 时，webpack 开启的优化。

{
  "mode": "production",
  "optimization": {
    // 告诉 webpack 肯定和标记块，这些块是其余块的子集，当更大的块已经被加载时，不须要加载这些子集。
    "flagIncludedChunks": true,
    // 告诉 webpack 找出一个模块的顺序，这可使打包出来的入口 bundle.js 最小化。
    "occurrenceOrder": true,
    // 肯定每一个模块下导出被使用的。
    "usedExports": true,
    // 告诉 webpack 查找能够安全地链接到单个模块的模块图的片断。取决于优化。
    "concatenateModules": true,
    // 使用 UglifyjsWebpackPlugin 进行代码压缩。
    "minimize": true
  },
  // 性能相关配置
  "performance": {
    "hints": "error",
    // ...
  }
}
复制代码

mode: development 时，webpack 开启的优化。

{
  "mode": "development",
  // 生成 source map 的格式选择，这个选项能够直接影响构建速度。
  "devtool": "eval",
  // 缓存模块，避免在未更改时重建它们。
  "cache": true,
  "module": {
    // 缓存已解决的依赖项，避免从新解析它们。
    "unsafeCache": true
  },
  "output": {
    // 在 bundle.js 中引入项目所包含模块的注释信息。
    "pathinfo": true
  },
  "optimization": {
    // 在可能的状况下肯定每一个模块的导出。
    "providedExports": true,
    // 找到 chunk 中共享的模块，取出来生成单独的 chunk。
    // 该配置用于代码分割打包，取代了曾经的 CommonsChunkPlugin 插件。
    "splitChunks": true,
    // 为 webpack 运行时代码建立单独的 chunk。
    "runtimeChunk": true,
    // 编译错误时不写入到输出。
    // 取代了曾经的 NoEmitOnErrorsPlugin 插件。
    "noEmitOnErrors": true,
    // 给模块更有意义更方便调试的名称。
    // 取代了曾经的 NamedModulesPlugin 插件。
    "namedModules": true,
    // 给 chunk 更有意义更方便调试的名称。
    "namedChunks": true,
  }
}
复制代码

webpack 4.x 基础版开发环境详细配置

基础版拥有 npm start 以后 打开一个新的网页，而且更改 js 会自动更新的功能，不包含对 ES6 语法的转义以及 css 打包，image 图片转为 dataURL 的功能。

先来一套组合拳，建立一个项目文件夹，并初始化项目。

md my-webpack-template
cd my-webpack-template
npm init -y
复制代码

接着能够参考个人目录结构（列出主要的文件，只针对 dev 环境）。

+---my-webpack-template
|       index.html
|       package.json
+---build
|       utils.js
|       build-server.js
|       webpack.base.conf.js
|       webpack.dev.conf.js
+---config
|       index.js
|       dev.env.js
+---src
|       index.js
复制代码

安装所需依赖。

webpack 和 webpack-cli 曾经是在一块儿的，在 4.x 版本中进行了拆分，因此若是很差好同时安装他们俩是不行的哦。

不推荐全局安装 webpack，这会致使命令行运行 webpack 的时候锁定版本。

npm install webpack webpack-cli -D
复制代码

webpack-dev-server 是一个专门用于开发环境使用的集成了众多功能的环境，基于 express，拥有即时编译代码（webapck-dev-middleware），热更新（webpack-hot-middleware），自动打开浏览器（opn），对 HTML5 中 history 作特殊处理（connect-history-api-fallback）等等功能。

对于开发环境，即时编译的代码不会存储在硬盘中而是在内存中，这是由 webapck-dev-middleware 完成的功能。

npm install webpack-dev-server -D
复制代码

用于合并 webpack 配置的，通常咱们会把 webpack 的 base 配置和 dev 配置 和 prod 配置分开写，用这个工具就能够很方便的合并 base 和 dev 的配置。

npm install webpack-merge -D
复制代码

一个用于处理打包这个进程的插件，能够清除打包时候残留的控制台信息，而且能够在控制台打印出打包成功以后的文字提示，固然，对于打包错误以后的回调也是有的。

npm install friendly-errors-webpack-plugin -D
复制代码

这个相对来讲各位看官应该用的不少了吧，用于生成一个 html 文件，而且能够在底部注入经过 webpack 打包好的 bundle.js 文件。

npm install html-webpack-plugin -D
复制代码

一个寻找可用端口的工具，当你配置的端口被占用时，这个工具会自动寻找一个可用的端口。

npm install portfinder -D
复制代码

配置 package.json 中的运行脚本

接着，安装完了依赖咱们须要配置 npm 运行时候的脚本了。

当你在命令行直接输入 webpack 报错的，而且确信本身已经安装了 webpack 的时候，试试直接配置 package.json 中的 scripts，说不定你安装的是项目中的 webpack，而 package.json 中运行的脚本将优先该项目的环境。

"scripts": {
  "dev": "webpack-dev-server --inline --progress --config build/build-server.js",
  "start": "npm run dev"
}
复制代码

build/webpack.base.conf.js 配置详解

先来配置 webpack 基础的配置，这里的配置 prod 和 dev 相同。

// 将一些配置写在 config/index.js 中，方便直接获取
var config = require("../config");

// 获取项目的初始目录，包装了个小函数
function resolve(file) {
  return path.resolve(__dirname, "../", file)
}

module.exports = {
  // webpack 处理打包文件的时候的初始目录
  context: resolve("./")，
  // 入口文件，webapck 4.x 默认的就是 src/index.js
  entry: {
    app: "./src/index.js"
  }，
  // 输出文件的目录
  output: {
    path: config.build.assetsRoot，
    filename: "[name].js"，
    publicPath: process.env.NODE_ENV === "production" ?
      config.build.assetsPublicPath : config.dev.assetsPublicPath
  }
}
复制代码

build/webpack.dev.conf.js 配置详解

// 将一些配置写在 config/index.js 中，方便直接获取
var config = require("../config");
var devConfig = config.dev;
// 一些工具函数
var utils = require("./utils");
// nodeJs 内置的函数，专门用来解析路径
var path = require("path");
// 大名鼎鼎的 webpack
var webpack = require("webpack");
var merge = require("webpack-merge");
var HtmlWebpackPlugin = require("html-webpack-plugin");
var webpackBaseConfig = require("./webpack.base.conf");

module.exports = merge(webpackBaseConfig，{
  // 配置开发环境 mode
  mode: "development"，
  // 一句话，这是个方便开发工具进行代码定位的配置
  // 可是不一样的配置会影响编译速度和打包速度，这里使用了和 vue-cli 一样的配置
  devtool: devConfig.devtool，
  // 使用了 webpack-dev-server 以后就须要有的配置
  // 在这里能够配置详细的开发环境
  devServer: {
    // 当咱们在 package.json 中使用 webpack-dev-server --inline 模式的时候
    // 咱们在 chrome 的开发工具的控制台 console 能够看到信息种类
    // 可选 none error warning info
    clientLogLevel: "warning"，
    // 不用担忧：要解决这个问题，你所须要作的就是在你的服务器上添加一个简单的万能回退路线。若是URL不匹配任何静态资产，那么它应该服务于相同的索引。你的应用程序所在的html页面。又漂亮! --- by vue-router
    // 这个配置就是应用了 connect-history-api-fallback 插件
    // 想象一个场景，vue 开发，咱们利用 vue-router 的 history 模式进行单页面中的页面跳转
    // www.demo.com 跳转去 www.demo.com/list
    // 看起来没毛病，vue-router 中只要配置了 list 的路由便可
    // 可是，当你刷新页面的时候，浏览器会去向服务器请求 www.demo.com/list 的资源，这想固然是找不到的
    // 这个中间件就是会自动捕获这个错误，而后将它从新定位到 index.html
    historyApiFallback: {
      rewrites: [{
        from: /.*/，
        to: path.posix.join(devConfig.assetsPublicPath，"index.html")
      }]
    }，
    // webpack 最有用的功能之一 --- by webpack
    // 热更新装置启动
    hot: true，
    // 告诉 webpack-dev-server 搭建服务器的时候从哪里获取静态文件
    // 默认状况下，将使用当前工做目录做为提供静态文件的目录
    // contentBase: false，
    // 搭建的开发服务器启动 gzip 压缩
    compress: true，
    // 搭建的开发服务器的 host，这里使用了一个函数去获取当前电脑的局域网 ip
    // 这个能够获取你的电脑的 ip 地址，而后开发服务器就能够搭建在局域网里
    // 若是有一同开发的小伙伴，在同一局域网内就能够直接访问地址看到你的页面
    // 一样，这个也适用于手机，连上同一个 wifi 以后就能够在手机上实时看到修改的效果
    host: utils.getIPAdress()，
    // 开发服务器的端口号
    // 可是后面咱们会用到 portfinder 插件，若是真的 config/index.js 中的端口被占用了
    // 那这个插件会以这个为 basePort 去找一个没有被占用的端口
    port: devConfig.port，
    // 是否要服务器搭建完成以后自动打开浏览器
    open: devConfig.autoOpenBrowser，
    // 是否打开发现错误以后在浏览器全屏幕显示错误信息功能
    overlay: devConfig.errorOverlay ? {
      warnings: false，
      errors: true
    } : false，
    // 此路径下的打包文件可在浏览器中访问
    // 假设服务器运行在 http://localhost:8080 而且 output.filename 被设置为 bundle.js
    // 默认 publicPath 是 "/"，因此 bundle.js 能够经过 http://localhost:8080/bundle.js 访问
    publicPath: devConfig.assetsPublicPath，
    // 启动接口访问代理
    proxy: devConfig.proxyTable，
    // 启用 quiet 后，除了初始启动信息以外的任何内容都不会被打印到控制台
    // 和 FriendlyErrorsPlugin 配合食用更佳
    quiet: true，
    // 开启监听文件修改的功能，在 webpack-dev-server 和 webpack-dev-middleware 中是默认开始的
    // watch: true，
    // 关于上面 watch 的一些选项配置
    watchOptions: {
      // 排除一些文件监听，这有利于提升性能
      // 这里排除了 node_modules 文件夹的监听
      // 可是这在应对须要 npm install 一些新的 module 的时候，就须要重启服务
      ignored: /node_modules/，
      // 是否开始轮询，有的时候文件已经更改了可是却没有被监听到，这时候就能够开始轮询
      // 可是比较消耗性能，选择关闭
      poll: devConfig.poll
    }
  }，
  plugins: [
    // 这能够建立一个在编译过程当中的全局变量
    // 由于这个插件直接执行文本替换，给定的值必须包含字符串自己内的实际引号 --- by webpack
    // 因此须要这么用
    // "process.env": JSON.stringify('development')
    // 或者
    // "process.env": '"development"'
    new webpack.DefinePlugin({
      "process.env": require("../config/dev.env")
    })，
    // 开启大名鼎鼎的热更新插件
    new webpack.HotModuleReplacementPlugin()，
    // 使用大名鼎鼎（词穷）的 html-webpack-plugin 模板插件
    new HtmlWebpackPlugin({
      // 输出的 html 文件的名字
      filename: "index.html"，
      // 使用的 html 模板名字
      template: "index.html"，
      // 是否要插入 weback 打包好的 bundle.js 文件
      inject: true
    })
  ]
})
复制代码

build/build-server.js 配置详解

// 更友好的提示插件
var FriendlyErrorsPlugin = require("friendly-errors-webpack-plugin");
// 获取一个可用的 port 的插件
var portfinder = require("portfinder");
var devWebpackConfig = require("./webpack.dev.conf");

// 导出一个 promise 函数，这可让 wepback 接受一个异步加载的配置
// 并在 resolve 的时候运行 这个配置
// 好比这里我就用到了 portfinder 和 friendly-errors-webpack-plugin
module.exports = new Promise((resolve，reject) => {
  // 设置插件的初始搜寻端口号
  portfinder.basePort = devWebpackConfig.devServer.port
  portfinder.getPort((err，port) => {
    if (err) reject(err)
    else {
      // 这里就利用 portfinder 获得了可使用的端口
      devWebpackConfig.devServer.port = port
      devWebpackConfig.plugins.push(new FriendlyErrorsPlugin({
        // 清除控制台原有的信息
        clearConsole: true，
        // 打包成功以后在控制台给予开发者的提示
        compilationSuccessInfo: {
          messages: [`开发环境启动成功，项目运行在: http://${devWebpackConfig.devServer.host}:${port}`]
        }，
        // 打包发生错误的时候
        onErrors: () => { console.log("打包失败") }
      }))
      resolve(devWebpackConfig)
    }
  })
})
复制代码

编译出错了？看看这里

若是你发现直接在控制台执行 webpack 报错了，可是你确实执行了 npm install，那是由于你没有安装全局的 webpack。

• 能够执行 .\node_modules\.bin\webpack --config webpack.config.js
  • 调用该项目 node_modules 下的 webpack
• 使用 package.json 配置让 npm 去找该项目中的 webpack
  • package.json > scripts.build: webapck

DeprecationWarning: Tapable.plugin is deprecated. Use new API on '.hooks' instead

这个错误会发生在你使用的插件没有针对 webpack 4.x 升级。 这个时候只能去 github 提 issue 或者换一个 plugin 了。

还发现了其余的错？请直接私信我，或者在评论中留言。

后语

但愿本身所作的一些微小的事情能够帮助你们在漫漫前端路中更上一层楼，另外，周末了不要太沉迷于敲代码，多出去走走，散散步，运动运动，给本身的一周充实的大脑放个空。

若是你们以为我哪里写的不对，请不要犹豫，直接 diss 我 =3=

代码如人生，我甘之如饴。

我在这里 gayhub@jsjzh 欢迎来找我玩儿

向前看就是将来，向后看就是过去，从中取一段下来就是故事，而这只不过是那样的故事中很小的一部分而已。--- 灰色的果实

大纲

• webpack 4.x 的那些新玩意儿（DONE）
  • mode
  • optimization
• webpack 4.x 基础版开发环境详细配置（DONE）
  • package.json 中的 devDependencies
  • package.json 中的 scripts
  • build/webpack.base.conf.js 配置详解
  • build/webpack.dev.conf.js 配置详解
  • build/build-server.js 配置详解
• webpack 4.x 升级版开发环境详细配置（TODO）[分篇]
  • 利用 babel 转换 ES6 语法
  • 将 img 转为 dataURL
  • 打包 css
  • 使用 vue-loader 或其余 loader 来完成更多
  • 本身动手开发一个 webpack-plugin
• webpack 4.x 生产环境详细配置（TODO）[分篇]
• webpack 配置优化（TODO）[分篇]
  • 打包速度优化
  • 打包体积优化