zoukankan      html  css  js  c++  java
  • webpack基本用法

    参考:

    https://zhuanlan.zhihu.com/p/28245984(知乎:webpack原理总结)

    https://segmentfault.com/a/1190000006178770(入门webpack,看这篇就够了)

    http://www.xbhub.com/wiki/webpack/ (深入浅出webpack)

    源码解读

    node_modules/目录下:

    .bin/webpack

    "$basedir/node"  "$basedir/../webpack/bin/webpack.js" "$@"

    webpack/bin/webpack.js,调用npm

    runCommand(packageManager, installOptions.concat(packageName))
                .then(() => {
                    require(packageName); //eslint-disable-line
                })
                .catch(error => {
                    console.error(error);
                    process.exitCode = 1;
                });  

    package.json

    "scripts": {
        "dev": "node build/dev-server.js",
        "build": "node build/build.js"
      },

    调用webpack

    webpack(webpackConfig, function (err, stats) {
      spinner.stop()
      if (err) throw err
      process.stdout.write(stats.toString({
        colors: true,
        modules: false,
        children: false,
        chunks: false,
        chunkModules: false
      }) + '
    ')
    })

    webpack/lib/webpack.js :使用配置文件编译

    options = new WebpackOptionsDefaulter().process(options);
    
            compiler = new Compiler(options.context);
            compiler.options = options;
            new NodeEnvironmentPlugin({
                infrastructureLogging: options.infrastructureLogging
            }).apply(compiler);
    //绑定插件
            if (options.plugins && Array.isArray(options.plugins)) {
                for (const plugin of options.plugins) {
                    if (typeof plugin === "function") {
                        plugin.call(compiler, compiler);
                    } else {
                        plugin.apply(compiler);
                    }
                }
            }
            compiler.hooks.environment.call();
            compiler.hooks.afterEnvironment.call();
    
            compiler.options = new WebpackOptionsApply().process(options, compiler);
    //必须有回掉才会编译,并且是链式编译
    if (callback) {
            if (typeof callback !== "function") {
                throw new Error("Invalid argument: callback");
            }
            if (
                options.watch === true ||
                (Array.isArray(options) && options.some(o => o.watch))
            ) {
                const watchOptions = Array.isArray(options)
                    ? options.map(o => o.watchOptions || {})
                    : options.watchOptions || {};
                return compiler.watch(watchOptions, callback);
            }
            compiler.run(callback);
        }
        return compiler;

    webpack/lib/Compiler.js 编译原理

    Webpack 的运行流程是一个串行的过程,从启动到结束会依次执行以下流程:

    1. 初始化参数:从配置文件和 Shell 语句中读取与合并参数,得出最终的参数;
    2. 开始编译:用上一步得到的参数初始化 Compiler 对象,加载所有配置的插件,执行对象的 run 方法开始执行编译;
    3. 确定入口:根据配置中的 entry 找出所有的入口文件;
    4. 编译模块:从入口文件出发,调用所有配置的 Loader 对模块进行翻译,再找出该模块依赖的模块,再递归本步骤直到所有入口依赖的文件都经过了本步骤的处理;
    5. 完成模块编译:在经过第4步使用 Loader 翻译完所有模块后,得到了每个模块被翻译后的最终内容以及它们之间的依赖关系;
    6. 输出资源:根据入口和模块之间的依赖关系,组装成一个个包含多个模块的 Chunk,再把每个 Chunk 转换成一个单独的文件加入到输出列表,这步是可以修改输出内容的最后机会;
    7. 输出完成:在确定好输出内容后,根据配置确定输出的路径和文件名,把文件内容写入到文件系统。

    在以上过程中,Webpack 会在特定的时间点广播出特定的事件,插件在监听到感兴趣的事件后会执行特定的逻辑

    Compiler和Compilation对象

    在开发 Plugin 时最常用的两个对象就是 Compiler 和 Compilation,它们是 Plugin 和 Webpack 之间的桥梁。 Compiler 和 Compilation 的含义如下:
    
    Compiler 对象包含了 Webpack 环境所有的的配置信息,包含 options,loaders,plugins 这些信息,这个对象在 Webpack 启动时候被实例化,它是全局唯一的,可以简单地把它理解为 Webpack 实例;
    Compilation 对象包含了当前的模块资源、编译生成资源、变化的文件等。当 Webpack 以开发模式运行时,每当检测到一个文件变化,一次新的 Compilation 将被创建。Compilation 对象也提供了很多事件回调供插件做扩展。通过 Compilation 也能读取到 Compiler 对象。
    Compiler 和 Compilation 的区别在于:Compiler 代表了整个 Webpack 从启动到关闭的生命周期,而 Compilation 只是代表了一次新的编译。

    事件流:

    Webpack 就像一条生产线,要经过一系列处理流程后才能将源文件转换成输出结果。 这条生产线上的每个处理流程的职责都是单一的,多个流程之间有存在依赖关系,只有完成当前处理后才能交给下一个流程去处理。 插件就像是一个插入到生产线中的一个功能,在特定的时机对生产线上的资源做处理。

    Webpack 通过 Tapable 来组织这条复杂的生产线。 Webpack 在运行过程中会广播事件,插件只需要监听它所关心的事件,就能加入到这条生产线中,去改变生产线的运作。 Webpack 的事件流机制保证了插件的有序性,使得整个系统扩展性很好。

    Webpack 的事件流机制应用了观察者模式,和 Node.js 中的 EventEmitter 非常相似。 Compiler 和 Compilation 都继承自 Tapable,可以直接在 Compiler 和 Compilation 对象上广播和监听事件。

    继承关系
    class Compiler extends Tapable {}
    /**
    * 广播出事件
    * event-name 为事件名称,注意不要和现有的事件重名
    * params 为附带的参数
    */
    compiler.apply('event-name',params);
    
    /**
    * 监听名称为 event-name 的事件,当 event-name 事件发生时,函数就会被执行。
    * 同时函数中的 params 参数为广播事件时附带的参数。
    */
    compiler.plugin('event-name',function(params) {
    
    });

    Tapable 事件流

    Tapable.addCompatLayer = function addCompatLayer(instance) {
        Tapable.call(instance);
        instance.plugin = Tapable.prototype.plugin;
        instance.apply = Tapable.prototype.apply;
    };
    
    Tapable.prototype.plugin = util.deprecate(function plugin(name, fn) {
        if (Array.isArray(name)) {
            name.forEach(function(name) {
                this.plugin(name, fn);
            }, this);
            return;
        }
        const result = this._pluginCompat.call({
            name: name,
            fn: fn,
            names: new Set([name])
        });
        if (!result) {
            throw new Error(
                `Plugin could not be registered at '${name}'. Hook was not found.
    ` +
                    "BREAKING CHANGE: There need to exist a hook at 'this.hooks'. " +
                    "To create a compatibility layer for this hook, hook into 'this._pluginCompat'."
            );
        }
    }, "Tapable.plugin is deprecated. Use new API on `.hooks` instead");
    
    Tapable.prototype.apply = util.deprecate(function apply() {
        for (var i = 0; i < arguments.length; i++) {
            arguments[i].apply(this);
        }
    }, "Tapable.apply is deprecated. Call apply on the plugin directly instead");

    配置

    文件结构

    const path = require('path');
    
    module.exports = {
      // entry 表示 入口,Webpack 执行构建的第一步将从 Entry 开始,可抽象成输入。
      // 类型可以是 string | object | array   
      entry: './app/entry', // 只有1个入口,入口只有1个文件
      entry: ['./app/entry1', './app/entry2'], // 只有1个入口,入口有2个文件
      entry: { // 有2个入口
        a: './app/entry-a',
        b: ['./app/entry-b1', './app/entry-b2']
      },
    
      // 如何输出结果:在 Webpack 经过一系列处理后,如何输出最终想要的代码。
      output: {
        // 输出文件存放的目录,必须是 string 类型的绝对路径。
        path: path.resolve(__dirname, 'dist'),
    
        // 输出文件的名称
        filename: 'bundle.js', // 完整的名称
        filename: '[name].js', // 当配置了多个 entry 时,通过名称模版为不同的 entry 生成不同的文件名称
        filename: '[chunkhash].js', // 根据文件内容 hash 值生成文件名称,用于浏览器长时间缓存文件
    
        // 发布到线上的所有资源的 URL 前缀,string 类型
        publicPath: '/assets/', // 放到指定目录下
        publicPath: '', // 放到根目录下
        publicPath: 'https://cdn.example.com/', // 放到 CDN 上去
    
        // 导出库的名称,string 类型
        // 不填它时,默认输出格式是匿名的立即执行函数
        library: 'MyLibrary',
    
        // 导出库的类型,枚举类型,默认是 var
        // 可以是 umd | umd2 | commonjs2 | commonjs | amd | this | var | assign | window | global | jsonp ,
        libraryTarget: 'umd', 
    
        // 是否包含有用的文件路径信息到生成的代码里去,boolean 类型
        pathinfo: true, 
    
        // 附加 Chunk 的文件名称
        chunkFilename: '[id].js',
        chunkFilename: '[chunkhash].js',
    
        // JSONP 异步加载资源时的回调函数名称,需要和服务端搭配使用
        jsonpFunction: 'myWebpackJsonp',
    
        // 生成的 Source Map 文件名称
        sourceMapFilename: '[file].map',
    
        // 浏览器开发者工具里显示的源码模块名称
        devtoolModuleFilenameTemplate: 'webpack:///[resource-path]',
    
        // 异步加载跨域的资源时使用的方式
        crossOriginLoading: 'use-credentials',
        crossOriginLoading: 'anonymous',
        crossOriginLoading: false,
      },
    
      // 配置模块相关
      module: {
        rules: [ // 配置 Loader
          {  
            test: /.jsx?$/, // 正则匹配命中要使用 Loader 的文件
            include: [ // 只会命中这里面的文件
              path.resolve(__dirname, 'app')
            ],
            exclude: [ // 忽略这里面的文件
              path.resolve(__dirname, 'app/demo-files')
            ],
            use: [ // 使用那些 Loader,有先后次序,从后往前执行
              'style-loader', // 直接使用 Loader 的名称
              {
                loader: 'css-loader',      
                options: { // 给 html-loader 传一些参数
                }
              }
            ]
          },
        ],
        noParse: [ // 不用解析和处理的模块
          /special-library.js$/  // 用正则匹配
        ],
      },
    
      // 配置插件
      plugins: [
      ],
    
      // 配置寻找模块的规则
      resolve: { 
        modules: [ // 寻找模块的根目录,array 类型,默认以 node_modules 为根目录
          'node_modules',
          path.resolve(__dirname, 'app')
        ],
        extensions: ['.js', '.json', '.jsx', '.css'], // 模块的后缀名
        alias: { // 模块别名配置,用于映射模块
           // 把 'module' 映射 'new-module',同样的 'module/path/file' 也会被映射成 'new-module/path/file'
          'module': 'new-module',
          // 使用结尾符号 $ 后,把 'only-module' 映射成 'new-module',
          // 但是不像上面的,'module/path/file' 不会被映射成 'new-module/path/file'
          'only-module$': 'new-module', 
        },
        alias: [ // alias 还支持使用数组来更详细的配置
          {
            name: 'module', // 老的模块
            alias: 'new-module', // 新的模块
            // 是否是只映射模块,如果是 true 只有 'module' 会被映射,如果是 false 'module/inner/path' 也会被映射
            onlyModule: true, 
          }
        ],
        symlinks: true, // 是否跟随文件软链接去搜寻模块的路径
        descriptionFiles: ['package.json'], // 模块的描述文件
        mainFields: ['main'], // 模块的描述文件里的描述入口的文件的字段名称
        enforceExtension: false, // 是否强制导入语句必须要写明文件后缀
      },
    
      // 输出文件性能检查配置
      performance: { 
        hints: 'warning', // 有性能问题时输出警告
        hints: 'error', // 有性能问题时输出错误
        hints: false, // 关闭性能检查
        maxAssetSize: 200000, // 最大文件大小 (单位 bytes)
        maxEntrypointSize: 400000, // 最大入口文件大小 (单位 bytes)
        assetFilter: function(assetFilename) { // 过滤要检查的文件
          return assetFilename.endsWith('.css') || assetFilename.endsWith('.js');
        }
      },
    
      devtool: 'source-map', // 配置 source-map 类型
    
      context: __dirname, // Webpack 使用的根目录,string 类型必须是绝对路径
    
      // 配置输出代码的运行环境
      target: 'web', // 浏览器,默认
      target: 'webworker', // WebWorker
      target: 'node', // Node.js,使用 `require` 语句加载 Chunk 代码
      target: 'async-node', // Node.js,异步加载 Chunk 代码
      target: 'node-webkit', // nw.js
      target: 'electron-main', // electron, 主线程
      target: 'electron-renderer', // electron, 渲染线程
    
      externals: { // 使用来自 JavaScript 运行环境提供的全局变量
        jquery: 'jQuery'
      },
    
      stats: { // 控制台输出日志控制
        assets: true,
        colors: true,
        errors: true,
        errorDetails: true,
        hash: true,
      },
    
      devServer: { // DevServer 相关的配置
        proxy: { // 代理到后端服务接口
          '/api': 'http://localhost:3000'
        },
        contentBase: path.join(__dirname, 'public'), // 配置 DevServer HTTP 服务器的文件根目录
        compress: true, // 是否开启 gzip 压缩
        historyApiFallback: true, // 是否开发 HTML5 History API 网页
        hot: true, // 是否开启模块热替换功能
        https: false, // 是否开启 HTTPS 模式
        },
    
        profile: true, // 是否捕捉 Webpack 构建的性能信息,用于分析什么原因导致构建性能不佳
    
        cache: false, // 是否启用缓存提升构建速度
    
        watch: true, // 是否开始
        watchOptions: { // 监听模式选项
        // 不监听的文件或文件夹,支持正则匹配。默认为空
        ignored: /node_modules/,
        // 监听到变化发生后会等300ms再去执行动作,防止文件更新太快导致重新编译频率太高
        // 默认为300ms 
        aggregateTimeout: 300,
        // 判断文件是否发生变化是不停的去询问系统指定文件有没有变化,默认每秒问 1000 次
        poll: 1000
      },
    }

    优化

    ParallelUglifyPlugin

    ParallelUglifyPlugin 就做了这个事情。 当 Webpack 有多个 JavaScript 文件需要输出和压缩时,原本会使用 UglifyJS 去一个个挨着压缩再输出, 但是 ParallelUglifyPlugin 则会开启多个子进程,把对多个文件的压缩工作分配给多个子进程去完成,每个子进程其实还是通过 UglifyJS 去压缩代码,但是变成了并行执行。 所以 ParallelUglifyPlugin 能更快的完成对多个文件的压缩工作。

    使用 ParallelUglifyPlugin 也非常简单,把原来 Webpack 配置文件中内置的 UglifyJsPlugin 去掉后,再替换成 ParallelUglifyPlugin

    const path = require('path');
    const DefinePlugin = require('webpack/lib/DefinePlugin');
    const ParallelUglifyPlugin = require('webpack-parallel-uglify-plugin');
    
    module.exports = {
      plugins: [
        // 使用 ParallelUglifyPlugin 并行压缩输出的 JS 代码
        new ParallelUglifyPlugin({
          // 传递给 UglifyJS 的参数
          uglifyJS: {
            output: {
              // 最紧凑的输出
              beautify: false,
              // 删除所有的注释
              comments: false,
            },
            compress: {
              // 在UglifyJs删除没有用到的代码时不输出警告
              warnings: false,
              // 删除所有的 `console` 语句,可以兼容ie浏览器
              drop_console: true,
              // 内嵌定义了但是只用到一次的变量
              collapse_vars: true,
              // 提取出出现多次但是没有定义成变量去引用的静态值
              reduce_vars: true,
            }
          },
        }),
      ],
    };

    区分环境:if (process.env.NODE_ENV === 'production') 

    提取公共代码

    const CommonsChunkPlugin = require('webpack/lib/optimize/CommonsChunkPlugin');
    
    new CommonsChunkPlugin({
      // 从哪些 Chunk 中提取
      chunks: ['a', 'b'],
      // 提取出的公共部分形成一个新的 Chunk,这个新 Chunk 的名称
      name: 'common'
    })
    
    new CommonsChunkPlugin({
      // 从 common 和 base 两个现成的 Chunk 中提取公共的部分
      chunks: ['common', 'base'],
      // 把公共的部分放到 base 中
      name: 'base'
    })
    
    // 所有页面都依赖的基础库
    import 'react';
    import 'react-dom';
    // 所有页面都使用的样式
    import './base.css';

    按需加载

    参考:http://www.xbhub.com/wiki/webpack/4%E4%BC%98%E5%8C%96/4-12%E6%8C%89%E9%9C%80%E5%8A%A0%E8%BD%BD.html

    Prepack

    const PrepackWebpackPlugin = require('prepack-webpack-plugin').default;
    
    module.exports = {
      plugins: [
        new PrepackWebpackPlugin()
      ]
    };
  • 相关阅读:
    fibonacci封闭公式及矩阵连乘
    fibonacci封闭公式
    fibonacci高精度加法
    fibonacci数列的和取余(1)
    fibonacci数列的和取余(2)
    [html][javascript]父子窗体传值
    [转]父子页面之间跨域通信的方法
    [转]批处理遍历文件夹生成 html 文件
    [原]DataGridView 回车不换行代码 AND 编辑时的字符控制
    [转]身份证从 15 >> 18
  • 原文地址:https://www.cnblogs.com/tkzc2013/p/11019424.html
Copyright © 2011-2022 走看看