工具系列——webpack2的学习

时间 2019-11-13

标签工具系列 webpack2 webpack 学习繁體版

原文原文链接

webpack2学习css

1. webpack2基本介绍

1.1. 介绍

webpack和gulp同样是一个自动化的构建工具
- 你不想作的东西都交给工具去作，好比混淆，压缩，移动，合并，添加浏览器兼容性词缀
gulp更适合作简单的流程性的操做，webpack是专门为处理SPA应用的复杂文件依赖而出现的html
- 如图
- js引用css，js引用图片，css引用图片，css引用字体，sass引用sass
- webpack就能够把上面的东西css都抽出来，全部的图片都抽出来
webpack主要用于react和vue的构建,普通的静态页面用gulp就足够了

1.2. 官网

webpack2:https://webpack.js.org/
webpack1:http://webpack.github.io/docs/

1.3. webpack1和webpack2的一些区别

webpack2已经不支持在配置文件中自定义属性
webpack2中在加载器中若是用了options属性那么必须配合loader属性使用，不能用use
webpack2中-loader必定要写全
webpack2中webpack-dev-server要单独下载2.x版本，默认是下载1.x版本
https://github.com/jawil/webpack2

1.4. 快速开始

1.4.1. 新建项目结构

1.4.2. 安装依赖

npm install webpack -g
npm install webpack -save-dev

1.4.3. 编写配置文件

var path=require('path')

module.exports = {
    // 指定spa应用的入口文件
    entry: path.resolve(__dirname, 'src/js/app.js'),
    // 指定项目构建的输出位置
    output: {
        path: path.resolve(__dirname, 'dist'),
        filename: 'bundle.js',
    }
}

1.4.4. 运行

在项目根目录执行webpack能够启动默认配置文件webpack.config.js
运行指定配置文件执行webpack --config webpack.develop.config.js

1.4.5. 把运行命令放到package.json文件中

启动命令还能够加不少参数webpack --config webpack.develop.config.js --progress --profile --colors
这么多参数不可能都记住，因此将启动命令写到package.json的script标签中

1.4.6. 监听代码变化自动从新构建

代码的变更须要屡次运行npm run develop因此咱们须要自动监听代码变更，而后运行构建，因而咱们用到了webpack-dev-server这个模块

1.4.6.1. webpack-deve-server介绍

webpack-dev-server封装了webpack和http模块
- 因此webpack的全部命令，webpack-deve-server均可以使用
- webpack-dev-server能够指定一个文件夹启动一个服务
  - webpack-dev-server启动的服务全部的内容都构建在内存中
  - 由于构建在内存中速度快，还有一个功能，就是没有变化的文件，不从新构建，只有变化了的文件才重新执行构建
做用
- 一是监听文件变化自动从新构建
- 二是自动刷新浏览器，能够热更新

1.4.6.2. 基本使用

下载npm install webpack-dev-server@9.9.9 -save-dev,注意选择2.x版本的模块
修改package.json文件中的命令webpack-dev-server --config webpack.develop.config.js --progress --profile --colors

修改开发配置文件vue

webpack2中推荐全部的服务配置信息都写到配置文件中的devServer属性中，不要写在package.json中

基本配置node

devServer: {
   // 指定启动服务的更目录
   contentBase: __dirname + '/src',
   // 指定端口号
   port: 8080,
   host: 'localhost',
   // 如下信息无关紧要，为了完整
   inline: true, 
   historyApiFallback: true,
   noInfo: false,
   // stats: 'minimal',
   // publicPath: publicPath
},

1.4.6.3. 热更新

能够不刷新浏览器更新
修改配置文件

devServer: {
    // 指定启动服务的更目录
    contentBase: __dirname + '/src',
    // 指定端口号
    port: 8080,
    host: 'localhost',
    // 启用热更新
    hot: true,
    // 如下信息无关紧要，为了完整
    inline: true, 
    historyApiFallback: true,
    noInfo: false,
    // stats: 'minimal',
    // publicPath: publicPath
},

须要配合一个内置插件一块儿使用

var webpack=require('webpack')

plugins: [
   new webpack.HotModuleReplacementPlugin(),
]

2. Loaders（加载器）

在真正构建以前作一些预处理操做就叫加载器

2.1. 处理es六、es七、jsx语法加载器

npm install babel-loader --save-dev
npm install babel-core babel-preset-es2015 babel-preset-react -save-dev
npm install babel-preset-stage-0 babel-preset-stage-1 babel-preset-stage-2 babel-preset-stage-3 --save-dev
npm install babel-plugin-transform-runtime -save-dev这个插件的做用是支持es7特性
修改配置文件

module: {
        rules: [
            {
                test: /\.jsx?$/,
                exclude: /node_modules/,
                use: [
                    {
                        loader: "babel-loader"
                    }
                ]
            }
        ]
    }

建立.babelrc文件

{
  "presets": [
    "es2015",
    "react",
    "stage-0",
    "stage-1",
    "stage-2",
    "stage-3"
  ],
  "plugins": [
    "transform-runtime"
  ]
}

2.2. 处理css文件引用的加载器

npm install style-loader css-loader -save-dev
修改配置文件

// 处理在js中引用css文件
{
    test: /\.css$/,
    use: ['style-loader', 'css-loader'],
},

2.3. 处理scss或者less文件引用的加载器

npm install sass-loader less-loader node-sass -save-dev
修改配置文件

// 处理在js中引用scss文件
{
    test: /\.scss$/,
    use: ['style-loader', 'css-loader', 'sass-loader'],
},
{
    test: /\.less$/,
    use: ['style-loader', 'css-loader', 'less-loader'],
},

2.4. 处理图片引用的加载器

npm install url-loader file-loader -save-dev
修改配置文件

// 处理图片操做  25000bit ~3kb
{
    test: /\.(png|jpg|jpeg|gif)$/,
    use: 'url-loader'
},

2.5. 处理字体文件引用的加载器

npm install url-loader file-loader -save-dev
修改配置文件

// 处理字体文件
{
    test: /\.(eot|woff|ttf|woff2|svg)$/,
    use: 'url-loader'
}

2.6. 处理浏览器兼容前缀

npm install postcss-loader autoprefixer -save-dev
修改配置文件

{
    test: /\.css$/,
    use: ExtractTextPlugin.extract({
        fallbackLoader: "style-loader",
        loader: "css-loader!postcss-loader"
    })
},
// 处理在js中引用scss文件
{
    test: /\.scss$/,
    use: ExtractTextPlugin.extract({
        fallbackLoader: "style-loader",
        loader: "css-loader!postcss-loader!sass-loader"
    })
},
{
    test: /\.less$/,
    use: ExtractTextPlugin.extract({
        fallbackLoader: "style-loader",
        loader: "css-loader!postcss-loader!less-loader"
    })
},

新建postcss.config.js

module.exports = {
  plugins: [
    require('autoprefixer')({browsers:'last 2 versions'})
  ]
}

2.7. 处理统一风格管理

npm install eslint-loader -save-dev
修改配置文件

// 这个只是加载器部分的写法，具体使用请看eslint文档
{
    enforce: "pre",
    test: /\.js$/,
    exclude: /node_modules/,
    loader: "eslint-loader",
    options:{
        configFile:'.eslintrc.js'
    }
},

2.8. 处理vue文件

npm install vue-loader -save-dev
修改配置文件

{
    test: /\.vue$/,
    loader: 'vue-loader',
    options: {
        loaders: {
            js: [
                    'babel-loader',
                    {
                        loader: "eslint-loader",
                        options: {
                            configFile: '.eslintrc.js'
                        }
                    }
            ],
            css: 'style-loader!css-loader'
        }
    }
},

3. 发布策略

简单的说就是将开发阶段的配置文件复制一份到部署的配置文件中，而后删删改改就能够了
把热更新插件删除，devServer属性删除
修改图片处理和字体处理加载器

// 处理图片操做  25000bit ~3kb
{
    test: /\.(png|jpg|jpeg|gif)$/,
    use: 'url-loader?limit=25000&name=images/[name].[ext]'
},
// 处理字体文件
{
    test: /\.(eot|woff|ttf|woff2|svg)$/,
    use: 'url-loader?limit=100000&name=fonts/[name].[ext]'
}

接下来运行npm run publish就发布了
不过要注意全部的css，js，图片都构建到一个bundle.js文件中了

4. Plugins（插件）

在真正构建以后作一些后处理操做就叫插件

4.1. 删除插件

npm install clean-webpack-plugin -save-dev
使用

var CleanPlugin = require('clean-webpack-plugin');

plugins: [
    // 删除文件夹的插件
    new CleanPlugin(['dist'])
]

4.2. 抽取公共js插件

使用

entry: {
        app: path.resolve(__dirname, 'src/js/app.js'),
        vendors: ['vue','vue-router','vuex']
    },


plugins: [
    // 分离第三方应用的插件
    new webpack.optimize.CommonsChunkPlugin({name: 'vendors', filename: 'vendors.js'}),
]

4.3. 提取样式文件插件

npm install extract-text-webpack-plugin@4.4.4 -save-dev注意下载2.x版本
使用

// 一、抽取css的第三方插件
var ExtractTextPlugin = require("extract-text-webpack-plugin");

// 二、处理在js中引用css文件
{
    test: /\.css$/,
    use: ExtractTextPlugin.extract({
        fallbackLoader: "style-loader",
        loader: "css-loader"
    })
},
// 处理在js中引用scss文件
{
    test: /\.scss$/,
    use: ExtractTextPlugin.extract({
        fallbackLoader: "style-loader",
        loader: "css-loader!sass-loader"
    })
},

//三、加一个插件
plugins: [
    // 删除文件夹的插件
    new ExtractTextPlugin("app.css"),
]

4.4. 自动生成html插件

npm install html-webpack-plugin -save-dev
在根目录建立template.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <title>webpack学习</title>
</head>
<body>
<div id="app"></div>
</body>
</html>

修改配置文件

var HtmlWebpackPlugin = require('html-webpack-plugin');

plugins: [
    // 自动生成html插件
   new HtmlWebpackPlugin({
       template: './src/template.html',
       htmlWebpackPlugin: {
           "files": {
               "css":["app.css"],
               "js": ["vendors.js", "bundle.js"]
           }
       },
       minify: {
           removeComments: true,
           collapseWhitespace: true,
           removeAttributeQuotes: true
       }
   }),
]

4.5. 压缩插件

修改配置文件

plugins: [
   // 压缩混淆js代码插件
   new webpack.optimize.UglifyJsPlugin({
       beautify: false,
       mangle: {
           screw_ie8: true,
           keep_fnames: true
       },
       compress: {
           warnings: false,
           screw_ie8: true
       },
       comments: false
   }),
]

4.6. 定义生产环境插件

修改配置文件

plugins: [
  // 在构建的过程当中删除警告
   new webpack.DefinePlugin({
       'process.env':{
           NODE_ENV:'"production"'
       }
   })
]

4.7. 自动打开浏览器插件

npm install open-browser-webpack-plugin -save-dev
使用

// 自动打开浏览器插件
var OpenBrowserPlugin = require('open-browser-webpack-plugin')

plugins: [
    // 删除文件夹的插件
   new OpenBrowserPlugin({url: 'http://localhost:8080/', browser: 'chrome'})
]

5. 高级

5.1. 和gulp的集成

npm install gulp del gulp-sequence -save-dev
编写配置文件

// gulp的任务是控制执行流程，webpack的任务是处理复杂引用的依赖

var gulp = require('gulp');
// 删除文件和目录
var del = require('del');
// 按顺序执行
var gulpSequence = require('gulp-sequence');
// 引入webpack的本地模块
var webpack = require("webpack");
// 引入wbpack的配置文件
var webpackConfig = require("./webpack.publish.config.js");

gulp.task('default', ['sequence'], function () {
    console.log("项目构建成功");
});

// 流程控制
gulp.task('sequence', gulpSequence('clean','webpack'));

// 删除文件和文件夹
gulp.task('clean', function (cb) {
    //del('dist);// 若是直接给dist的目录，项目启动的顺序还有清除结果会报错，因此要写的更详细一些
    del(['dist/*.js', 'dist/*.css', 'dist/images', 'dist/fonts,','dist/*.html']).then(function () {
        cb()
    });
});


//写一个任务，在gulp中执行webpack的构建
// gulp 负责任务流程部分的操做，webpack负责复杂模块系统的引用分离工做
gulp.task('webpack', function (cb) {
    // 执行webpack的构建任务
    webpack(webpackConfig, function (err, stats) {

        if (err) {
            console.log("构建任务失败");
        } else {
            cb();
        }

    });
});

5.2. 和eslint的集成

5.3. 代码的异步加载

修改配置文件

output: {
    publicPath:'/',
    chunkFilename: '[name]_[chunkhash:8]_chunk.js'
},

代码中的写法react

react

<Route path="movieDetail/:id"
       getComponent={
           (nextState, callback)=> {
               require.ensure([], (require)=> {
                   callback(null, require("../containers/MovieDetailContainer.js").default)
               }, "movieDetail")
           }
       }
/>

const MovieContainer= r => require.ensure([], () => r(require('../containers/MovieContainer.vue')),'movie')

5.4. 组件库按需加载处理

5.4.1. react中的antd按需加载配置

npm install babel-plugin-import -save-dev
// 修改babel配置文件
{
  "presets": ["es2015", "react","stage-0","stage-1","stage-2","stage-3"],
  "plugins": [
    ["import", { "libraryName": "antd","style": "css" }]
  ]
}

5.4.2. vue中的element按需加载配置

npm install babel-plugin-component-save-dev
// 修改babel配置文件
{
  "presets": [
    "es2015",
    "react",
    "stage-0",
    "stage-1",
    "stage-2",
    "stage-3"
  ],
  "plugins": [
    "transform-runtime",
    [
      "component",
      [
        {
          "libraryName": "element-ui",
          "styleLibraryName": "theme-default"
        }
      ]
    ]
  ]
}

6. 其余

6.1. 启用source-map

如今的代码是合并之后的代码，不利于排错和定位，只须要在config中添加

devtool: 'source-map',

output: {
    sourceMapFilename: '[name].map'
},

这样出错之后就会采用source-map的形式直接显示你出错代码的位置。

6.2. 加载jQuery plugin或者其余legacy第三方库

你的项目有时候会要加载各类各样的第三方库，好比一些jQuery的插件，它们都依赖jQuery，但若是直接引用就会报错jQuery is not undefined这类的错误，由于一些老的库不支持AMD或者CommonJS等一些先进的格式，因此有几种方法解决

// plugin.js
(function ($) {
    const shade = "#556b2f";
    $.fn.greenify = function() {
        this.css( "color", shade );
        return this;
    };
}(jQuery));

6.2.1. 方法一：webpack.ProvidePlugin

做用：把一个全局变量插入到全部的代码中
修改配置文件

plugins: [
    //provide $, jQuery and window.jQuery to every script
    new webpack.ProvidePlugin({
      $: "jquery",
      jQuery: "jquery",
      "window.jQuery": "jquery"
    })
  ]

//这个也不须要了 由于$, jQuery, window.jQuery已经被注入到每个js中，均可以直接使用了
//import $ from 'jquery';
import './plugin.js';
...
myPromise.then((number) => {
  $('body').append('<p>promise result is ' + number + ' now is ' + moment().format() + '</p>');
  //call our jquery plugin!
  $('p').greenify();
});

6.2.2. 方法二：import-loader

npm install imports-loader --save-dev
修改配置文件

//注意这种写法 咱们把jQuery这个变量直接插入到plugin.js里面了
//至关于在这个文件的开始添加了 var jQuery = require('jquery');
import 'imports?jQuery=jquery!./plugin.js';

//后面的代码同样
myPromise.then((number) => {
  $('body').append('<p>promise result is ' + number + ' now is ' + moment().format() + '</p>');
  //call our jquery plugin!
  $('p').greenify();
});

6.3. exports-loader

从模块中导出变量的功能

// 直接绑定在全局变量window上面
// Hello.js
window.Hello = function(){
    console.log('say hello.');
}


//而后咱们在index.js文件里去引用这个Hello.js:var hello = require('./Hello.js');。这样引用的结果是变量hello是
//undefined。由于咱们在Hello.js文件里没有写module.exports=window.Hello，因此index.js里咱们require的结果就是
//undefined。这个时候，exports-loader就派上用场了。咱们只用把index.js的代码稍微改动一下：var hello = require
//('exports?window.Hello!./Hello.js');，这个时候，代码就能正确的运行了。变量hello就是咱们定义的window.hello啦。
//var hello = require('exports?window.Hello!./Hello.js');这行代码，等于在Hello.js里加上一句module
//.exports=window.Hello，因此咱们才能正确的导入。

6.4. expose-loader

把一个模块导出并付给一个全局变量

require("expose?libraryName!./file.js");
// Exposes the exports for file.js to the global context on property "libraryName".
// In web browsers, window.libraryName is then available


//例子中的注释是说把file.js中exports出来的变量付给全局变量"libraryName"。假如file.js中有代码module.exports=1，那么
//require("expose?libraryName!./file.js")后window.libraryName的值就为1（咱们这里只讨论浏览器环境）

6.5. resolve属性

resolve: {
    //注意一下, extensions webpack2第一个不是空字符串! 对应不须要后缀的状况.
    extensions: ['.js', '.json', '.sass', '.scss', '.less', 'jsx', '.vue'],
    //模块别名定义，方便后续直接引用别名，无须多写长长的地址
    alias: {
        'assets': path.resolve(__dirname, './src/assets'),
        'components': path.resolve(__dirname, './src/components')
    }
},

6.6. external属性

// 配置了这个属性以后 vue 和 vue-router这些第三方的包都不会被构建进 js 中，那么咱们就须要经过 cdn 进行文件的引用了
//externals对象的key是给require时用的，好比require('vue'),，对象的value表示的是如何在global（即window）中访问到该对象，这里是window.Vue
externals: {
    'vue': 'Vue',
    'vue-router': 'VueRouter'
},

免责说明

一、本博客中的文章摘自网上的众多博客，仅做为本身知识的补充和整理，并分享给其余须要的coder，不会用于商用jquery

二、由于不少博客的地址已经记不清楚了，因此不会在这里标明出处webpack

1. webpack2系列step1--HTML
2. webpack2系列step2--CSS
3. webpack2学习(二)
4. webpack2学习(一)
5. 分析工具学习笔记系列
6. webpack2学习随笔
7. Webpack2学习记录-1
8. Webpack2学习记录-2
9. pssh系列工具
10. 《工具系列》 - Cmder
更多相关文章...
• jQuery Mobile 工具栏 - jQuery Mobile 教程
• 您已经学习了 XML Schema，下一步学习什么呢？ - XML Schema 教程
• PHP开发工具
• 适用于PHP初学者的学习线路和建议