webpack进阶构建项目(一)

阅读目录

  • 1.理解webpack加载器
  • 2.html-webpack-plugin学习
  • 3.压缩js与css
  • 4.理解less-loader加载器的使用
  • 5.理解babel-loader加载器
  • 6.理解 extract-text-webpack-plugin(独立打包样式文件)
  • 7.webpack打包多个资源文件
  • 8.webpack对图片的打包
  • 9.学习web-dev-server 创建服务器及动态监听css及js文件的改变；
  • 10.assets-webpack-plugin插件解决html文件的版本号的问题；
  • 11.webpack关于同步加载和异步加载的问题

回到顶部

1.理解webpack加载器

webpack的设计理念，所有资源都是“模块”，webpack内部实现了一套资源加载机制，这与Requirejs、Sea.js、Browserify等实现有所不同.

Webpack提供了一套加载器，比如css-loader,less-loader,style-loader，url-loader等，用于将不同的文件加载到js文件中，比如url-loader用于在js中加载png/jpg格式的图片文件，css/style loader用于加载css文件，less-loader加载器是将less编译成css文件；比如代码配置如下：

module.exports = {
  entry: "./src/main.js",
  output: {
    filename: "build.js",
    path: __dirname + ‘/assets/‘,
    publicPath: "/assets/"
  },
  module: {
    loaders: [
      {test: /.css$/, loader: ‘style!css‘},
      {test: /.(png|jpg)$/, loader: ‘url-loader?limit=8192‘}
    ]
  }
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘],
    //模块别名定义，方便后续直接引用别名，无须多写长长的地址
    alias: {
        a : ‘js/assets/a.js‘,  // 后面直接引用 require(“a”)即可引用到模块
        b : ‘js/assets/b.js‘,
        c : ‘js/assets/c.js‘
    }
  },
  plugins: [commonsPlugin, new ExtractTextPlugin("[name].css")]
}

module.loader: 其中test是正则表达式，对符合的文件名使用相应的加载器./.css$/会匹配 xx.css文件，但是并不适用于xx.sass或者xx.css.zip文件.
url-loader: 它会将样式中引用到的图片转为模块来处理; 配置信息的参数“?limit=8192”表示将所有小于8kb的图片都转为base64形式。
entry: 模块的入口文件。依赖项数组中所有的文件会按顺序打包，每个文件进行依赖的递归查找，直到所有模块都被打成包；
output：模块的输出文件，其中有如下参数：
filename: 打包后的文件名
path: 打包文件存放的绝对路径。
publicPath: 网站运行时的访问路径。
relolve.extensions: 自动扩展文件的后缀名，比如我们在require模块的时候，可以不用写后缀名的。
relolve.alias: 模块别名定义，方便后续直接引用别名，无须多写长长的地址
plugins 是插件项;

回到顶部

2.html-webpack-plugin学习

首先来看看项目的目录结构如下：

package.json 如下：

{
  "name": "html-webpack-plugin",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "html-webpack-plugin": "^2.19.0",
    "webpack": "^1.13.1"
  }
}

运行命令 npm install 把依赖包加载出来；

接着在 webpack.config.js配置如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);

//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);
console.log(SRC_PATH)
module.exports = {

  entry: SRC_PATH + "/js/index.js",
  //输出的文件名 合并以后的js会命名为index.js
  output: {
    path: BUILD_PATH,
    filename: ‘index.js‘
  },
  //添加我们的插件 会自动生成一个html文件
  plugins: [
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘
    })
  ]
};

在项目中的根目录下 运行 webpack 就能生成buid文件夹了，里面会自动生成 两个文件 index.html和index.js文件；
index.html代码如下：

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>Hello World app</title>
  </head>
  <body>
  <script type="text/javascript" src="index.js"></script></body>
</html>

标题title就是我们配置上的；
且合并了依赖的js文件；我们可以直接在本地访问index.html 可以看到能打印出依赖的文件js代码了；可以看到可以解决依赖的问题；
html-webpack-plugin 还支持如下配置：
title: 用于生成的HTML文件的标题。
filename: 用于生成的HTML文件的名称，默认是index.html。你可以在这里指定子目录。
template: 模板文件路径，支持加载器，比如 html!./index.html
inject: true | ‘head‘ | ‘body‘ | false ,注入所有的资源到特定的 template 或者 templateContent 中，如果设置为 true
或者 body，所有的 javascript 资源将被放置到 body 元素的底部，‘head‘ 将放置到 head 元素中。
favicon: 添加特定的 favicon 路径到输出的 HTML 文件中。
minify:{ //压缩HTML文件
removeComments:true, //移除HTML中的注释
collapseWhitespace:true //删除空白符与换行符
}
hash: true | false, 如果为 true, 将添加一个唯一的 webpack 编译 hash 到所有包含的脚本和 CSS 文件，对于解除 cache 很有用。
cache: true | false，如果为 true, 这是默认值，仅仅在文件修改之后才会发布文件。
showErrors: true | false, 如果为 true, 这是默认值，错误信息会写入到 HTML 页面中
chunks: 允许只添加某些块 (比如，仅仅 unit test 块)
chunksSortMode: 允许控制块在添加到页面之前的排序方式，支持的值：‘none‘ | ‘default‘ | {function}-default:‘auto‘
excludeChunks: 允许跳过某些块，(比如，跳过单元测试的块)

比如我现在webpack.config.js配置改为如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);

//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);
console.log(SRC_PATH)
module.exports = {

  entry: SRC_PATH + "/js/index.js",
  //输出的文件名 合并以后的js会命名为index.js
  output: {
    path: BUILD_PATH,
    filename: ‘index.js‘
  },
  //添加我们的插件 会自动生成一个html文件
  plugins: [
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘1.0.0/home.html‘,
      inject: true,
      hash: true
    })
  ]
};

然后再在命令行中继续运行webpack命令，可以看到在build下会生成2个目录 第一个是build/1.0.1/home.html; 第二个是 build/index.js
再来看下home.html代码如下：

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>Hello World app</title>
  </head>
  <body>
  <script type="text/javascript" src="../index.js?d03211ff5e0251af224d"></script></body>
</html>

可以看到设置 hash为true js的后缀会自动加一个hash编码，对于页面解决缓存很有用；

生成多个 HTML 文件
通过在配置文件中添加多次这个插件，来生成多个 HTML 文件。
webpack.config.js代码如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);

//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);
console.log(SRC_PATH)
module.exports = {

  entry: SRC_PATH + "/js/index.js",
  //输出的文件名 合并以后的js会命名为index.js
  output: {
    path: BUILD_PATH,
    filename: ‘index.js‘
  },
  //添加我们的插件 会自动生成一个html文件
  plugins: [
    new HtmlwebpackPlugin(),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘app1/home.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    })
  ]
};

官网可以看这里 https://www.npmjs.com/package/html-webpack-plugin
也可以在配置项 加上minify选项 压缩HTML文件；代码如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);
console.log(SRC_PATH)
module.exports = {

  entry: SRC_PATH + "/js/index.js",
  //输出的文件名 合并以后的js会命名为index.js
  output: {
    path: BUILD_PATH,
    filename: ‘index.js‘
  },
  //添加我们的插件 会自动生成一个html文件
  plugins: [
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      minify:{ //压缩HTML文件
        removeComments:true,    //移除HTML中的注释
        collapseWhitespace:true    //删除空白符与换行符
      }
    })
  ]
};

查看html生成后的文件可以看到已经被压缩了；

回到顶部

3.压缩js与css

webpack已经内嵌了uglifyJS来完成对JS与CSS的压缩混淆，无需引用额外的插件。
压缩代码如下：

new webpack.optimize.UglifyJsPlugin({    //压缩代码
   compress: {
       warnings: false
   },
   except: [‘$super‘, ‘$‘, ‘exports‘, ‘require‘]    //排除关键字
})

这里需要注意的是压缩的时候需要排除一些关键字，不能混淆，比如$或者require，如果混淆的话就会影响到代码的正常运行。
webpack.config.js代码改为如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var webpack = require("webpack");
//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);
console.log(SRC_PATH)
module.exports = {

  entry: {
    ‘index‘ : SRC_PATH + "/js/index.js"
  },
  //输出的文件名 合并以后的js会命名为index.js
  output: {
    path: BUILD_PATH + ‘/js/‘,
    filename: ‘[name].js‘
  },
  //添加我们的插件 会自动生成一个html文件
  plugins: [
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      minify:{ //压缩HTML文件
        removeComments:true,    //移除HTML中的注释
        collapseWhitespace:true    //删除空白符与换行符
      }
    }),
    new webpack.optimize.UglifyJsPlugin({    //压缩代码
       compress: {
           warnings: false
       },
       except: [‘$super‘, ‘$‘, ‘exports‘, ‘require‘]    //排除关键字
    })
  ]
};

继续运行下webpack可以看到js已经被压缩了；注意：但是貌似对es6的语法不能压缩~

回到顶部

4.理解less-loader加载器的使用

我们先来理解下less-loader加载器，其他的sass-loader也是一个意思，less-loader加载器是把css代码转化到style标签内，

动态插入到head标签内；我们先来看看我项目的结构如下：

src/html/index.html代码如下：

<!DOCTYPE html>
 <html>
    <head>
        <meta http-equiv="content-type" content="text/html;charset=utf-8" />
        <meta content="width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no" name="viewport"/>
        <meta content="yes" name="apple-mobile-web-app-capable" />
        <meta content="black" name="apple-mobile-web-app-status-bar-style" />
        <meta content="telephone=no" name="format-detection" />
        <meta content="email=no" name="format-detection" />
        <meta name="description" content="基于webpack的前端工程化开发解决方案探索"/>
        <title>动态生成html的实践</title>
    </head>
    <body>
        <div>hello webpack</div>
    </body>
</html>

现在我想通过html-webpack-plugin插件动态生成 html页面及引入index.js 和 生成 index.js文件；

webpack.config.js代码配置如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);

module.exports = {
  entry: SRC_PATH + "/js/index.js",
  output: {
    filename: "build.js",
    path: BUILD_PATH
  },
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: "style!css!less"
      }
    ]
  },
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘]
  },
  plugins: [
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘index.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    })
  ]
};

在项目的根目录运行webpack,即可动态生成html文件和js文件，打开生成后的index.html即可看到css生效了，且css被动态内链到head标签内了；

其中less/main.less 文件如下代码：

@color: red;

body {
    background:@color;
}
如上可以看到less文件得到编译，且动态插入到head标签内；

回到顶部

5.理解babel-loader加载器

babel-loader加载器能将ES6的代码转换成ES5代码，我们需要安装babel-loader
执行命令：npm install babel-loader --save-dev
因此现在需要在webpack.config.js 加入babel-loader的加载器即可；如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);

module.exports = {
  entry: SRC_PATH + "/js/index.js",
  output: {
    filename: "build.js",
    path: BUILD_PATH
  },
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: "style!css!less"
      },
      {
        test: /\.js$/,
        loader: ‘babel‘
      }
    ]
  },
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘]
  },
  plugins: [
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘index.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    })
  ]
};

a.js 假如是ES6的语法；比如如下一句代码：
// es6的语法
let LOADER = true;
module.exports = LOADER;

现在在index.js代码如下：
var aModule = require(‘../less/main.less‘);
console.log(aModule);

// es6的语法
var aMoudle = require(‘./a‘);
console.log(aMoudle);

可以看到打印 aMoudle的值为true；说明可以正确的解析了；

回到顶部

6.理解 extract-text-webpack-plugin(独立打包样式文件)

执行安装命令：
sudo npm install extract-text-webpack-plugin
然后再webpack.config.js 加入加载器配置项如下代码：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var ExtractTextPlugin = require(‘extract-text-webpack-plugin‘);

//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);

module.exports = {
  entry: SRC_PATH + "/js/index.js",
  output: {
    filename: "build.js",
    path: BUILD_PATH
  },
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: ExtractTextPlugin.extract(
            ‘css?sourceMap!‘ +
            ‘less?sourceMap‘
        )
      },

      {
        test: /\.js$/,
        loader: ‘babel‘
      }
    ]
  },
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘]
  },
  plugins: [
    // 内联css提取到单独的styles的css
    new ExtractTextPlugin("index.css"),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘index.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    })
  ]
};

在项目的根目录运行 webpack 即可生效；会在build目录下 生成 index.css文件，且在打包后的index.html会自动引入link标签的css；
如下所示：

如果页面上有多个less文件或者css文件的话，也可以通过 @import 动态导入；如下在main.less 引入 a.less代码如下：
@import ‘./a.less‘;
a.less 是和main.less 同级目录下的；

回到顶部

7.webpack打包多个资源文件

我们在开发页面的时候，有时候需要有多个入口文件，做到文件是按需加载，这样就可以使用缓存提升性能；

只需要像如下编码即可：

module.exports = {
  entry: {
     "main": "./src/a.js",
     "index": "./src/index.js"
  },
  output: {
    filename: "[name].js"
  }
};

webpack.config.js代码如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var ExtractTextPlugin = require(‘extract-text-webpack-plugin‘);
var webpack = require("webpack");
//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);

module.exports = {
  entry: {
     "a": SRC_PATH + "/js/a.js",
     "index": SRC_PATH + "/js/index.js",
  },
  output: {
    filename: "[name].js",
    path: BUILD_PATH
  },
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: ExtractTextPlugin.extract(
            ‘css?sourceMap!‘ +
            ‘less?sourceMap‘
        )
      },

      {
        test: /\.js$/,
        loader: ‘babel‘
      }
    ]
  },
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘]
  },
  plugins: [
    // 内联css提取到单独的styles的css
    new ExtractTextPlugin("index.css"),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘index.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    }),
    new webpack.optimize.UglifyJsPlugin({    //压缩代码
       compress: {
           warnings: false
       },
       except: [‘$super‘, ‘$‘, ‘exports‘, ‘require‘]    //排除关键字
    })
  ]
};

回到顶部

8.webpack对图片的打包

图片是 url-loader来加载的，我们既可以在css文件里url的属性；

首先先安装 url-loader插件；
sudo npm install --save-dev url-loader

首先在less文件里面加入如下代码：
@color: red;
body {
background:@color;
background:url(‘../images/1.png‘) no-repeat;
}
在index.js里面加入如下代码：
var aModule = require(‘../less/main.less‘);
console.log(aModule);

在webpack.config.js代码配置加入如下：
{
test: /.(png|jpg)$/,
loader: ‘url?limit=8192‘
}
webpack.config.js所有代码如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var ExtractTextPlugin = require(‘extract-text-webpack-plugin‘);
var webpack = require("webpack");
//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);

module.exports = {

  entry: {
     "a": SRC_PATH + "/js/a.js",
     "index": SRC_PATH + "/js/index.js",
  },
  output: {
    filename: "[name].js",
    path: BUILD_PATH
  },
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: ExtractTextPlugin.extract(
            ‘css?sourceMap!‘ +
            ‘less?sourceMap‘
        )
      },

      {
        test: /\.js$/,
        loader: ‘babel‘
      },
      {
        test: /.(png|jpg)$/,
        loader: ‘url?limit=8192&name=img/[hash:8].[name].[ext]‘
      }
    ]
  },
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘]
  },
  plugins: [
    // 内联css提取到单独的styles的css
    new ExtractTextPlugin("index.css"),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘index.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    }),
    new webpack.optimize.UglifyJsPlugin({    //压缩代码
       compress: {
           warnings: false
       },
       except: [‘$super‘, ‘$‘, ‘exports‘, ‘require‘]    //排除关键字
    })
  ]
};

因此在项目的根目录运行webpack后，即可，然后会生成index.css文件代码如下：
body{background:red;background:url(8eaebaa98ed1fe64bbf9f0f954b2b230.png) no-repeat}
因此可以看到会动态转换成base64编码；

回到顶部

9.学习web-dev-server 创建服务器及动态监听css及js文件的改变；

在webpack中，我们经常使用webpack-dev-server作为开发服务器，用于实时监听和打包编译静态资源，这样每当我们修改js、css等等文件时，客户端（如浏览器等）能够自动刷新页面，展示实时的页面效果。

webpack-dev-server只监听webpack.config.js中entry入口下文件（如js、css等等）的变动，

只有这些文件的变动才会触发实时编译打包与页面刷新，但是html文件更改后保存不能监听新内容到，但是对于开发影响不大，我们在编写css文件
或者js文件的时候保存后，会自动刷新页面，所以html页面也会自动更新到；

首先需要进入我们的项目的根目录下需要安装webpack-dev-server 安装命令如下：
sudo npm install --save-dev webpack-dev-server

首先我项目的目录如下：

安装完成后，需要在webpack.config.js文件配置下；如下代码：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var ExtractTextPlugin = require(‘extract-text-webpack-plugin‘);
var webpack = require("webpack");

//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);

module.exports = {

  entry: {
     "a": SRC_PATH + "/js/a.js",
     "index": SRC_PATH + "/js/index.js"
  },

  output: {
    filename: "/js/[name].js",
    path: BUILD_PATH
  },
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: ExtractTextPlugin.extract(
            ‘css?sourceMap!‘ +
            ‘less?sourceMap‘
        )
      },

      {
        test: /\.js$/,
        loader: ‘babel‘
      },
      {
        test: /.(png|jpg)$/,
        loader: ‘url?limit=8192&name=images/[hash:8].[name].[ext]‘
      }
    ]
  },
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘]
  },
  plugins: [
    // 内联css提取到单独的styles的css
    new ExtractTextPlugin("/css/index.css"),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘html/index.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    }),
    new webpack.optimize.UglifyJsPlugin({    //压缩代码
       compress: {
           warnings: false
       },
       except: [‘$super‘, ‘$‘, ‘exports‘, ‘require‘]    //排除关键字
    })
  ]
};

接着需要创建一个webpack-config-dev.js文件，该文件的作用是创建本地服务器，及实时监听css及js文件的改变；代码如下：

var path = require(‘path‘)
var webpack = require(‘webpack‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var ExtractTextPlugin = require(‘extract-text-webpack-plugin‘);

module.exports = {
  devtool: ‘cheap-eval-source-map‘,
  entry: [
    ‘webpack-dev-server/client?http://127.0.0.1:8080‘,
    ‘webpack/hot/dev-server‘,
    ‘./src/js/index‘,
    ‘./src/js/a‘,
    ‘./src/less/main.less‘
  ],
  output: {
    path: path.join(__dirname, ‘build‘),
    filename: ‘/js/[name].js‘
  },
  plugins: [
    new webpack.HotModuleReplacementPlugin(),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘html/index.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    }),
    new ExtractTextPlugin("index.css")
  ],
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: ExtractTextPlugin.extract(
            ‘css?sourceMap!‘ +
            ‘less?sourceMap‘
        )
      },

      {
        test: /\.js$/,
        loader: ‘babel‘
      },
      {
        test: /.(png|jpg)$/,
        loader: ‘url?limit=8192&name=images/[hash:8].[name].[ext]‘
      }
    ]
  },
  devServer: {
    contentBase: ‘./dist‘,
    hot: true
  }
}

上面只是在开发环境配置的；我们还需要一个线上环境，进行打包，我们还需要使用一个线上环境打包的配置；我们可以新建一个叫webpack.config.prod.js文件； 该文件的配置用于在生产环境的打包；配置代码如下：

var path = require(‘path‘)
var webpack = require(‘webpack‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var ExtractTextPlugin = require(‘extract-text-webpack-plugin‘);

module.exports = {
  devtool: ‘source-map‘,
  entry: [‘./src/js/index‘,‘./src/js/a‘],
  output: {
    path: path.join(__dirname, ‘build‘),
    filename: ‘/js/[name].js‘
  },
  plugins: [
    new webpack.HotModuleReplacementPlugin(),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘html/index.html‘,
      template: ‘src/html/index.html‘,
      inject: true,
      hash: true
    }),
    new ExtractTextPlugin("index.css")
  ],
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: ExtractTextPlugin.extract(
            ‘css?sourceMap!‘ +
            ‘less?sourceMap‘
        )
      },

      {
        test: /\.js$/,
        loader: ‘babel‘
      },
      {
        test: /.(png|jpg)$/,
        loader: ‘url?limit=8192&name=images/[hash:8].[name].[ext]‘
      }
    ]
  }
}

package.json文件代码如下：

{
  "name": "html-webpack-plugin",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "build": "webpack --config webpack.config.prod.js",
    "dev": "webpack-dev-server --config webpack.config.dev.js"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "babel-core": "^6.9.1",
    "babel-loader": "^6.2.4",
    "css-loader": "^0.23.1",
    "file-loader": "^0.8.5",
    "html-webpack-plugin": "^2.19.0",
    "http-server": "^0.9.0",
    "less": "^2.7.1",
    "less-loader": "^2.2.3",
    "react-hot-loader": "^1.3.0",
    "style-loader": "^0.13.1",
    "url-loader": "^0.5.7",
    "webpack": "^1.13.1",
    "webpack-dev-server": "^1.14.1"
  }
}

接着我们先运行webpack，就可以在项目的根目录下生成build文件夹了；
如下图所示：

为了更方便运行我们在package.json添加如下代码：
"scripts": {
     "build": "webpack --config webpack.config.prod.js",
     "dev": "webpack-dev-server --config webpack.config.dev.js"
}
因此如果在开发环境的话，可以运行 npm run dec; 如果是线上的环境，可以运行 npm run build 即可;
但是当我们运行 npm run dev的时候 会出现如下错误：

这是因为 默认centos的 hosts 会把本地 127.0.0.1 localhost 注释掉； 我们可以在我们hosts文件夹下 多加一句
127.0.0.1 localhost
即可；
我们可以参考 https://github.com/Unitech/pm2/issues/324

webpack-dev-server git上的地址：https://github.com/tugenhua0707/webpack-dev-server

回到顶部

10.assets-webpack-plugin插件解决html文件的版本号的问题；

我们上面学习过 html-webpack-plugin 这个插件，它可以自动添加版本号，但是对于很多前端开发的时候，我们的html页面是放在服务器端那边的部署，架构是前后端分离，因为html是在后台的，所以根本操作不了html，也不应该耦合。

我们可以通过webpack的 assets-webpack-plugin 插件生成一个记录了版本号的文件；详细的可以看官网地址是： https://www.npmjs.com/package/assets-webpack-plugin;
首先我们需要在我们的项目下安装该插件：安装命令如下：
npm install assets-webpack-plugin --save-dev
只需要在webpack.config.json添加如下代码：

// 部分代码
var AssetsPlugin = require(‘assets-webpack-plugin‘);
new AssetsPlugin({
    filename: ‘build/webpack.assets.js‘,
    processOutput: function (assets) {
        return ‘window.WEBPACK_ASSETS = ‘ + JSON.stringify(assets);
    }
})

我们现在来在webpack.config.js配置项如下

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var ExtractTextPlugin = require(‘extract-text-webpack-plugin‘);

//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);

var AssetsPlugin = require(‘assets-webpack-plugin‘);

module.exports = {
  entry: {
     "a": SRC_PATH + "/js/a.js",
     "index": SRC_PATH + "/js/index.js"
  },
  output: {
    path: path.join(__dirname, "build"),
    filename: "js/[name]-[chunkhash:8].js",
  },
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: ExtractTextPlugin.extract(
            ‘css?sourceMap!‘ +
            ‘less?sourceMap‘
        )
      },

      {
        test: /\.js$/,
        loader: ‘babel‘
      }
    ]
  },
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘]
  },
  plugins: [
    // 内联css提取到单独的styles的css
    new ExtractTextPlugin("css/index.css"),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘html/index.html‘,
      template: ‘src/html/index.html‘,
      inject: true
    }),
    new AssetsPlugin({
        filename: ‘build/webpack.assets.js‘,
        processOutput: function (assets) {
            return ‘window.WEBPACK_ASSETS = ‘ + JSON.stringify(assets);
        }
    })
  ]
};

然后运行webpack命令进行打包后 如下图所示：

可以看到在我们的build目录下的js文件生成a和index带有版本号的js文件，在build目录下还生成了一个 webpack.assets.js文件；该文件
代码如下：
window.WEBPACK_ASSETS = {"a":{"js":"js/a-a7cbb4daad866656445a.js"},
"index":{"js":"js/index-a7cbb4daad866656445a.js"}}

因此我们可以把该webpack.assets.js文件让开发在页面上引入即可；
<script src="build/webpack.assets.js?v=‘ + Math.random() + ‘"></script>
<script src="‘ + window.WEBPACK_ASSETS[‘a‘].js + ‘"></script>
<script src="‘ + window.WEBPACK_ASSETS[‘index‘].js + ‘"></script>

我们继续看 chunkhash:8 的含义：其中8是指hash长度为8，默认是16。加上chunkhash就可以缓存文件；因为每次打包的时候都会自动生成
版本号，但是有些文件并没有修改的话，我们不需要更改版本号，我们想直接从缓存里面读取，对于更改的文件我们需要从服务器下载，对于
这样的 chunkhash 可以解决；比如如下两次的版本号：
window.WEBPACK_ASSETS = {"a":{"js":"js/a-ac4c0d24.js"},"index":{"js":"js/index-7c5ec642.js"}}
当我更改index.js代码的时候 a.js代码没有更改的话；变成如下：
window.WEBPACK_ASSETS = {"a":{"js":"js/a-ac4c0d24.js"},"index":{"js":"js/index-9a2fec25.js"}}

回到顶部

11.webpack关于同步加载和异步加载的问题

使用webpack打包，直接使用require模块可以解决模块的依赖的问题，

对于直接require模块，WebPack的做法是把依赖的文件都打包在一起，造成文件很臃肿。即是同步加载，同步的代码会被合成并且打包在一起；
而 异步加载的代码会被分片成一个个chunk，在需要该模块时再加载，即按需加载，同步加载过多代码会造成文件过大影响加载速度；
异步过多则文件太碎，造成过多的Http请求，同样影响加载速度。这要看开发者自己权衡下；
同步加载的写法如下：
var aModule = require(‘./a‘);
而异步加载的写法如下：
require.ensure([‘./a‘],function(require){
     var aModule = require(‘./a‘);
},‘tips‘);
使用 require.ensure 可以解决异步加载模块的文件；如上代码，如果ensure不指定第三个参数的话(tips),那么webpack会随机生成一个数字
作为模块名，我们指定第三个参数为tips；那说明生成后的模块名叫tips.js；
这时候我们需要使用到webpack.config.js中的output选项需要加一个配置项：chunkFilename: "[name].min.js"

下面可以先来理解下 webpack中的output.filename 和output.chunkFilename
比如如下配置代码：

{
  entry: {
    "index": "pages/index.jsx"
  },
  output: {
    filename: "[name].min.js",
    chunkFilename: "[name].min.js"
  }
}

filename应该比较好理解，就是对应于entry里面生成出来的文件名；即会生成 index.min.js文件名；
chunkname的理解是在按需加载（异步）模块的时候，这样的文件是没有被列在entry中的，如使用CommonJS的方式异步加载模块时候会使用到；
比如如上这要异步加载一个a.js模块，代码如下：
require.ensure([‘./a‘],function(require){
    var aModule = require(‘./a‘);
},‘tips‘);
指定第三个参数为tips，因此配合output中的 chunkFilename， 即会生成 tips.min.js了；
比如如下所示：

tips.js代码如下：

webpackJsonp([1],[
/* 0 */,
/* 1 */
/***/ function(module, exports) {

  /*
  // es6的语法
  let LOADER = true;
  module.exports = LOADER;
  */

  function a() {
    console.log("a");
    console.log(11);
    console.log(222444);
  }
  a();

/***/ }
]);

会通过 webpackJsonp 模块包装一下；接着我们在index.js代码看下，它使如何被调用的；如下片段代码：
__webpack_require__.e/* nsure */(1, function (require) {
     var aModule = __webpack_require__(1);
});
即可引用的到；也就是说如果a.js模块有1000+行代码，不会被包含到index.js代码内，但是index.js代码有a.js代码模块的引用；
可以加载到a.js代码的内容；
下面是我的webpack.config.js代码配置如下：

var path = require(‘path‘);
var HtmlwebpackPlugin = require(‘html-webpack-plugin‘);
var ExtractTextPlugin = require(‘extract-text-webpack-plugin‘);

//定义了一些文件夹的路径
var ROOT_PATH = path.resolve(__dirname);

var SRC_PATH = path.resolve(ROOT_PATH, ‘src‘);

var BUILD_PATH = path.resolve(ROOT_PATH, ‘build‘);

var AssetsPlugin = require(‘assets-webpack-plugin‘);

module.exports = {
  entry: {
     "index": SRC_PATH + "/js/index.js"
  },
  output: {
    path: path.join(__dirname, "build"),
    filename: "js/[name]-[chunkhash:8].js",
    chunkFilename: "js/[name]-[chunkhash:8].js"
  },
  module: {
    loaders: [
      //.css 文件使用 style-loader 和 css-loader 来处理
      {
        test: /\.less$/,
        loader: ExtractTextPlugin.extract(
            ‘css?sourceMap!‘ +
            ‘less?sourceMap‘
        )
      },

      {
        test: /\.js$/,
        loader: ‘babel‘
      }
    ]
  },
  resolve: {
    extensions: [‘‘, ‘.js‘, ‘.jsx‘]
  },
  plugins: [
    // 内联css提取到单独的styles的css
    new ExtractTextPlugin("css/index.css"),
    new HtmlwebpackPlugin({
      title: ‘Hello World app‘,
      filename: ‘html/index.html‘,
      template: ‘src/html/index.html‘,
      inject: true
    }),
    new AssetsPlugin({
        filename: ‘build/webpack.assets.js‘,
        processOutput: function (assets) {
            return ‘window.WEBPACK_ASSETS = ‘ + JSON.stringify(assets);
        }
    })
  ]
};

index.js代码异步调用a.js模块的代码如下：
require.ensure([‘./a‘],function(require){
    var aModule = require(‘./a‘);
},‘tips‘);
更多的配置项 看官网 http://webpack.github.io/docs/code-splitting.html

时间： 2024-10-03 00:48:58

webpack进阶构建项目(一)的相关文章

[转]webpack进阶构建项目(一)

阅读目录 1.理解webpack加载器 2.html-webpack-plugin学习 3.压缩js与css 4.理解less-loader加载器的使用 5.理解babel-loader加载器 6.理解 extract-text-webpack-plugin(独立打包样式文件) 7.webpack打包多个资源文件 8.webpack对图片的打包 9.学习web-dev-server 创建服务器及动态监听css及js文件的改变: 10.assets-webpack-plugin插件解决html文件

Vue-Router路由Vue-CLI脚手架和模块化开发 之 Vue-CLI 2.x脚手架工具基于webpack simple模板与基于webpack模板构建项目

Vue-CLI 2.x脚手架工具基于webpack simple模板构建项目 vue-cli是一个基于vue.js进行快速开发的完整系统.基于webpack构建,并进行默认配置,可通过插件扩展,可升级: vue-cli帮我们创建基本项目结构,跳过繁琐的项目配置环节,将精力集中在业务上: vue-cli的版本: @vue/cli 3.x版本:点击前往官网 vue-cli 2.x版本:点击前往官网 安装vue-cli $ npm install -g vue-cli 安装成功,查看其版本: 使用we

ES6+React+Webpack初步构建项目流程

当我们打算使用Webpack构建工具,React和ES6来开发项目的时候,构建这么一套自动化的项目的流程见下: 第一步:webpack是一个基于node的项目,我们使用命令行对webpack进行全局的安装 npm install webpack –g.可以通过webpack  –h来查看安装的版本信息.然后我们新建一个文件夹用来存放整个项目文件.为了可以在项目中使用webpack,我们需要将webpack安装到当前的项目依赖中,在新建的文件夹下输入:npm init(安装webpack依赖,会在

gulp进阶构建项目由浅入深

阅读目录 gulp基本安装和使用 gulp API介绍 Gulp.src(globs[,options]) gulp.dest(path[,options]) gulp.task(name[,deps],fn); gulp.watch(glob[,opts],tasks) gulp一些常用插件 gulp-rename(重命名) gulp-uglify(JS压缩) gulp-minify-css(css文件压缩) gulp-minify-html(html压缩) gulp-concat(JS文件合

最近在研究webpack来构建项目，说说安装node-sass模块是遇到的问题

首先我是个小白哈,第一次玩这东西,首先我为什么要去安装node-sass模块呢,因为不安装这个模块的话sass-loader就不能正常工作 就这样搞了一个近一天的时间才安装好node-sass模块,各种google,其实好多大神说的确实是可行的,但是作为小白并不是那么理解,所以今天来整理分享给大家,毕竟用sass来编写css那就叫一个字爽啊,可以节省很多代码量,下面来看看问题 首先小白遇到问题一般都是什么都不管,先看看咱们熟悉的报红, 生成启动时间为 2016/6/27 星期一 11:39:46

D1.1.利用npm（webpack）构建基本reactJS项目

前提: 已经安装nodejs和npm #全局安装webpack 自动构建化工具,职能管理项目:webpack-dev-server是开发工具,提供 Hot Module Replacement 功能# webpack 介绍:http://webpack.github.io/docs/what-is-webpack.html npm install -g webpack webpack-dev-server #在项目文件夹路径下,初始化npm项目 npm init #安装webpack和webpa

Vue2+VueRouter2+webpack 构建项目实战（二）：目录以及文件结构

通过上一篇博文<Vue2+VueRouter2+webpack 构建项目实战(一):准备工作>,我们已经新建好了一个基于vue+webpack的项目.本篇文章详细介绍下项目的结构. 项目目录以及文件结构 如图所示: 如上图所示,自动构建的vue项目的结构就是这样. 目录/文件 说明 build 这个是我们最终发布的时候会把代码发布在这里,在开发阶段,我们基本不用管. config 配置目录,默认配置没有问题,所以我们也不用管 node_modules 项目开发依赖的一些模块 src 开发目录(

webpack前端构建工具学习总结（四）之自动化生成项目中的html页面

接续上文:webpack前端构建工具学习总结(三)之webpack.config.js配置文件 1.安装html-webpack-plugin插件,输入命令:npm install html-webpack-plugin --save-dev 2.在webpack.config.js文件中,引入html-webpack-plugin插件 3.输入命令:npm run webpack,编译打包 可以看到在dist/js目录下新生成了一个index.html文件,并且引入了新编译生成的两个js,但此

[F2016061802] NodeJS之旅-使用webpack构建项目时代码正确但编译出错

遇到这个问题前,我对webpack还不算太熟,仅仅限于用它来编译ES6代码,代码写多了,问题也就来了. 一开始用NodeJS写些小项目,用的模块并不多,遇到些报错问题,改改也就通过了.然而,随着用的第三方模块增多,用webpack构建项目时出现错误的次数越来越多,最奇怪的是:代码检查了十几遍,明明任何错误都没有,编译却通不过.最后只能硬着头皮去看编译后的代码才明白问题出在哪里! 对于webpack,它是自动把依赖都输出到目标文件中.比如: import koa from 'koa' 构建后的输出