• 前后端分离之vue2.0+webpack2 实战项目 -- webpack介绍


    webpack的一点介绍

    Webpack 把任何一个文件都看成一个模块,模块间可以互相依赖(require or import),webpack 的功能是把相互依赖的文件打包在一起。webpack 本身只能处理原生的 JavaScript 模块,但是 loader 转换器可以将各种类型的资源转换成 JavaScript 模块。这样,任何资源都可以成为 Webpack 可以处理的模块。同时,webpack还有丰富的插件 plugin,可以完成例如js,css的压缩,公共依赖模块的提取和注入,甚至利用模板对 html 进行动态拼接等功能。
    
    同时,webpack 使用commonjs规范(require),支持es6语法(import)的编译,可以方便的抽离vue组件,这成为我们选择它的重要理由。

    对webpack工作方式直观的理解(官网小示例)

    import: es6 引入依赖的方式,还可以用commonjs 规范的require

    var bar  = require('./bar')

    module.exports: commonjs规范中对外暴露本模块接口的方式。每个模块内部,都有一个module对象,代表当前模块,module对象包含module.id,module.filename,module.exports等信息

    entry: 编译的入口js文件,即需要处理的js文件(所有的其他模块包括image,css,vue组件,html模板等都是通过js依赖引入进来的)

    output: 编译的出口js文件,即经过打包其他资源、合并、压缩等处理之后生成的js文件

    本示例中因为 app.js 依赖 bar.js ,所以打包之后的 bundle.js 可以理解为app.js和bar.js合并后的js

    命令行工具中运行:wepack 即编译成功


    实际项目中的webpack解析

    本项目已支持功能

     1 对less编译
     2 对js es6语法支持
     3 编译.vue组件,并自动内联组件样式
     4 图片打包,包括对html内图片处理(利用html-loader和es6字符串模板),对小图片生成base64
     5 利用htmlWebpackPlugin动态拼接html 的公共部分和内容部分,引入相应css/js资源,并构建到指定目录, 对ejs模板支持
     6 对js内依赖的css分离并压缩
     7 对js引用的公共模块抽取分离成单独文件
     8 区分开发环境和生产环境
     9 js 压缩
    10 静态文件(css/js/img)hash版本支持
    11 清除目标文件目录
    12 eslint支持并实现自动修复部分问题
    13 vue接口请求axios支持
    14 热更新,自动编译并刷新浏览器

     

    项目目录结构

      |__ html
            |__ dist
                  |__ income.html
                  |__ index.html
            |__ src
                  |__ income
                    |__ income.ejs
                    |__ income.js
                  |__ index
                    |__ index.ejs
                    |__ index.js
                  |__ layouts
                    |__ footer.ejs
                    |__ header.ejs
                    |__ layout.ejs
                    |__ layout.js
                    |__ side-menu.e
                    |__ top-nav.ejs
      |__ dist
            |__ css
            |__ img
            |__ js
                  |__ income.js
                  |__ index.js
                  |__ manifest.js
                  |__ vendors.js
      |__ src
            |__ css
            |__ img
            |__ js
                  |__ component
                    |__ App.vue
                  |__ income.js
                  |__ index.js
                  |__ lib
                    |__ axios.min.js
                    |__ layer.js
                    |__ vue.js
                    |__ vue.min.js
      |__ mock
      |__ node_modules
      |__ webpack-config
            |__ .eslintrc.dev.js
            |__ .eslintrc.js
            |__ postcss.config.js
            |__ resolve.config.js
      |__ package.json
      |__ .babelrc
      |__ .eslintrc.js

    一. entry介绍

    var entries = getEntry('./src/**/*.js') // 获得入口js文件
    entries.vendors = ['vue','axios']
    
    module.exports = {
         /* 输入文件 */
        entry: entries
    }

    通常我们的项目中有大量的js入口文件,基本一个功能页面有一个js,这时我们的 entry 文件为一个对象格式

    entries 为:

    { income:
    './src/js/income.js', index: './src/js/index.js', vendors: [ 'vue', 'axios' ] }

    key 值为对应模块的别名,webpack会依次处理这些模块。

    vendors 为公共模块,这里我们把vue, axios设置为公共模块,供下面进行提取公共模块操作。

    之所以可以直接写vue, axios,是因为我们在 alias 里设置了别名:

    var path = require('path')
    
    module.exports = {
      // 模块别名的配置,为了使用方便,一般来说所有模块都是要配置一下别名的
      alias: {
        'vue': path.resolve(__dirname, '../src/js/lib/vue.min.js'),
        'axios': path.resolve(__dirname, '../src/js/lib/axios.min.js')
      }
    }

    这里的 path.resolve 作用是把相对路径转为绝对路径,假设我项目建在d:/demo 目录下,

    _dirname: d:demo
    
    path.resolve(__dirname, '../src/js/lib/vue.min.js'): d:demosrcjslibvue.min.js

    getEntry() 为获取文件路径的自定义函数:

    /***** 获取文件列表:输出正确的js和html路径 *****/
    var glob = require('glob')

    function getEntry(globPath) { var entries = {}, basename glob.sync(globPath).forEach(function (entry) { //排出layouts内的公共文件 if(entry.indexOf('layouts') == -1 && entry.indexOf('lib') == -1){ basename = path.basename(entry, path.extname(entry)) entries[basename] = entry } }) return entries }

    通常webpack的entry入口文件,是功能性页面的js,对于js库等文件不需要列入入口文件进行处理。所以这里对lib文件夹进行了排除。layouts文件夹为获取html路径时需要排除的文件路径。

    二. output介绍

    module.exports = {
        output: {
            /* 输出目录,没有则新建 */
            path: path.resolve(__dirname, './dist'),
            /* 静态目录,可以直接从这里取文件 */
            publicPath: 'http://www.xxx.com/dist/',
            /* 文件名 */
            filename: 'js/[name].js?v=[chunkhash:8]'
        }
    }

     publicPath: 如果有这项,则html中的引用的js路径会加上publicPath,即 http://www.xxx.com/dist/js/[name].js?v=[chunkhash:8]

     filename: 这里可以自定义输出后的文件名,加上版本号

      [name] :输入模块的别名

      [chunkhash] : 模块的hash值,":8"代表保留8位hash值

      [hash] : 整个编译环境的hash值

    hash和chunkhash具体区别请看这里

    三. module介绍

    loaders: webpack利用各种loader来把不同格式的文件封装成模块加载到js内,比如css-loader, vue-loader

    特别注意:webpack v1 和webpack v2 的区别

    module: {
    - loaders: [ + rules: [ { test: /.css$/, - loaders: [ - "style-loader", - "css-loader?modules=true" + use: [ + { + loader: "style-loader" + }, + { + loader: "css-loader", + options: { + modules: true + } + } ] }, { test: /.jsx$/, loader: "babel-loader", // Do not use "use" here options: { // ... } } ] }

    eslint-loader

    module: {
        rules: [
               {
                    test: /.js$/,
                    enforce: 'pre',
                    loader: 'eslint-loader',
                    include: path.resolve(__dirname, './src/js/**/*.js'),
                    exclude: ['./src/js/lib','./src/js/component'],
                    options: {
                        fix: true
                    }
                }  
        ]          
    }    

    目的是 对js进行代码风格和语法的校验

    enforce: 注意这是webpack v2的变动,v1是 preLoaders。设置为pre表示对js的校验在编译之前进行,我们只负责自己写的js 语法和规范没有问题即可,编译后的代码什么样都不管。

    通常我们只对自己写的js进行校验,类库和包里的js无需校验。include即声明我们对哪些文件进行校验,相反,exclude是排除校验哪些文件。

    fix:true 即在编译时自动修复代码风格和语法问题

    babel-loader

    {
        test: /.js$/,
        loader: 'babel-loader',
        exclude: ['node_modules','./src/js/lib','./src/js/component']
    }

    es6语法目前很多浏览器不支持,我们需要将其转化为大部分浏览器支持的es5语法,这就需要babel-loader

    css-loader style-loader post-loader less-loader

    {   
        test: /.css$/, 
        use: ['style-loader', 'css-loader', 'postcss-loader']
    },
    {
        test: /.less$/,
        use: ExtractTextPlugin.extract(['css-loader','postcss-loader','less-loader'])
    }

    对于有多个loader时,webpack v2也废弃了v1的 " !" 连接,改为数组形式,且不能省略 " -loader " 以免造成名称混乱意思模糊,执行顺序为从右到左

    postcss-loader为集合处理css各种问题的平台,其上面有各种插件来处理css,我们这里只用到了autoprefixer插件,后面插件部分会详解

    style-loader:可以将css以style内联方式嵌入到html页面

    ExtractTextPlugin:提取css, 后面插件部分会进行详解

    file-loader url-loader 处理图片

    {
        test: /.(png|jpg|gif)$/,
        loader: 'url-loader?limit=5120&name=img/[name].[ext]?v=[hash:8]'
    }

    webpack中处理图片用file-loader,但url-loader有个好处,它可以把小图片转化成base64格式,其他的大图片再用file-loader处理,这里的limit即为临界值,这里定义小于5k图片转成base64格式,大于5k的用file-loader处理。

    name: 可以重新定义处理后的图片并加上版本值。

     四. 插件plugin 

    module: {},
    plugins: [
            new ExtractTextPlugin('css/[name].css?v=[contenthash:6]'),
            new webpack.LoaderOptionsPlugin({
                options: {
                    eslint: require( './webpack-config/.eslintrc.js'),
                    postcss: require( './webpack-config/postcss.config.js')
                },
            })
        ]

    插件可以补充loader的功能,对其进行丰富完善,webpack声明插件的方式可以像上面的写法也可以如下方式:

    module.exports.plugins.push(new htmlWebpackPlugin())

     亦或

    module.exports.plugins = module.exports.plugins.concat([
            //压缩css代码
            new OptimizeCssAssetsPlugin({
                assetNameRegExp: /.css/g,
                cssProcessor: require('cssnano'),
                cssProcessorOptions: { discardComments: {removeAll: true } },
                canPrint: true
            }),
            //压缩JS代码
            new webpack.optimize.UglifyJsPlugin({
                output: {
                    comments: false, // 去掉注释内容
                }
            })
        ])

    通常后两种写法用于动态的使用插件。

    extract-text-webpack-plugin 插件

    默认情况下,js依赖引入css,编译后,css被加在js中,如果我们想把css提取出一个单独的文件,可以使用这个插件,并可以对提取出的css进行自定义命名和加版本hash值

    income.js中依赖income.less

    如果不使用extractTextPlugin,编译后的目录结构为

    查看income.js,发现css被引入在js之中,模块id为16

    再看下webpack sourcemap下的income.less,css-loader已经将此文件编译成对外暴露的模块形式,模块id为16

    使用extractTextPlugin插件后

    income.js依赖的income.less被单独提出,income.js中引入的模块16发现提示 removed by extract-text-webpack-plugin,再看下此时的income.less

    提示 removed by extract-text-webpack-plugin , 说明此插件已经顺利的将js中的css提取成单文件形式

    同时发现html中已插入income.css

    这个是style-loader起的作用

    LoaderOptionsPlugin插件

    加载插件的配置项,比如eslint的语法配置,postcss的插件配置

    optimize-css-assets-webpack-plugin 插件

    压缩css文件,对从js中提取出的css文件亦有效

    注意:此插件是在css被提取出来加了hash值后进行处理,如果css文件提出来后被命名为  css/[name].css?v=[contenthash:8] 形式,插件的使用如下

    new OptimizeCssAssetsPlugin({
                assetNameRegExp: /.css/g,  //注意不要写成 /.css$/g, 否则匹配不到css文件会导致压缩不成功
                cssProcessor: require('cssnano'),
                cssProcessorOptions: { discardComments: {removeAll: true } },
                canPrint: true
            })

    html-webpack-plugin 插件

     用于根据模板组合html各个部分,并插入对应引用的js,对前后端分离贡献颇多,功能强大会有专门的篇章来介绍

     browser-sync-webpack-plugin 插件

    热更新,自动刷新浏览器

    var BrowserSyncPlugin = require('browser-sync-webpack-plugin')
    
    module.exports = {
        plugins: [
            new BrowserSyncPlugin({
                host: 'localhost',
                port: 3000,
                server: { baseDir: ['./'] }
            })
        ]
    }

    baseDir: localhost:3000 指定的目录

    结合webpack的watch,可以做到实时编译并刷新浏览器

    只需要  webpack --watch  即可

    CommonsChunkPlugin 插件

    提取js的公共模块,此插件为webpack自带的插件

    // 提取公共模块
    new webpack.optimize.CommonsChunkPlugin({
        names:  ['vendors', 'manifest'], // 公共模块的名称
        //filename: 'js/[name]-[chunkhash:6].js', // 公共模块的名称
        chunks: 'vendors',  // chunks是需要提取的模块
        minChunks: Infinity  //公共模块最小被引用的次数
    })

    通常我们的js可能会引入一些公共js文件,包括一些类库,如果都打包在一个js中,这个js会变得非常庞大,而且一旦我们功能页面的js有变化,会导致打包后的js版本号进行更新然后重新加载,这个代价有些大,所以我们会考虑把一些公共的js文件提取出一个单独的文件,这样在第一次访问的时候会加载,之后就可以缓存下来,减少服务器请求的压力并提高加载速度。

    names: 定义公共js模块的文件名,即vendors.js,manifest是为了存储webpack编译逻辑的一些信息,也会生成一个manifest.js并引入html。如果不生成manifest文件,这些webpack的编译逻辑信息就会存储在vendors中,当incomejs等页面的功能js变化时,也会导致这个公共js的hash值变化,这样又会导致重新加载100多k的vendor.js,这就失去了我们提取公共模块的意义。

    而如果多生成一个manifest.js文件,会发现,当incomejs等页面页面功能js变化时,只有manifest.js的hash值有更新,vendors.js的hash值不变,虽然这样会导致重新请求manifest.js但它的体积不过几kb,代价远小于vendorjs,所以我们可以用这种方式来优化我们公共js模块的加载方式。

     官网如下解释,可供参考:

    To extract the webpack bootstrap logic into a separate file, use the CommonsChunkPlugin on a name which is not defined as entry. Commonly the name manifest is used. See the code splitting libraries guide for details.
    new webpack.optimize.CommonsChunkPlugin({
      name: "manifest",
      minChunks: Infinity
    })

    filename: 我们可以重命名公共模块的文件名格式,此举会覆盖output中的文件名命名方式,不定义这个属性默认用output中的filename方式

    chunks:需要提取的模块,在entry中我们有如下定义  entries.vendors = ['vue','axios']  所以定义   chunks: 'vendors'  就是我们会提取vuejs axiosjs到公共js中

    minChunks: 公共模块最小被引用的次数, 可以写成2,3...。Infinity: with more entries, this ensures that no other module goes into the vendor chunk,推荐用infinity

     CleanWebpackPlugin插件

     清除目标文件

    new CleanWebpackPlugin(['dist'])

    源码:https://github.com/saysmy/vue2-webpack2-demo

    如有错误请指正

    html模板拼接详解请见:前后端分离之vue2.0+webpack2 实战项目 -- html模板拼接

    转载请注明出处 https://i.cnblogs.com/EditPosts.aspx?postid=6635504

  • 相关阅读:
    Windows进程通信(2)使用内存映射文件
    VC2010添加头文件目录
    CString(ANSI/Unicode)与string/wstring的安全转换
    1005 ( Number Sequence )
    1004 ( Let the Balloon Rise )
    1003 ( Max Sum )
    CreateMutex
    CloseHandle
    delphi的Frame简单演示
    DLL中显示模式窗体
  • 原文地址:https://www.cnblogs.com/saysmy/p/6635504.html
Copyright © 2020-2023  润新知