美文网首页
webpack4+配置的一个简单例子

webpack4+配置的一个简单例子

作者: 阳春boy | 来源:发表于2018-12-16 21:52 被阅读0次

    由于react和vue官方提供的脚手架想要增加一些额外的需求改起来太麻烦了,于是我就自己搭了一个webpack的例子,这个例子主要实现了下面的功能(在文章最后也会附上我自己搭建的一个react的脚手架):

    1. 支持es6语法
    2. 支持css和less的编译
    3. 支持autoprefixer
    4. 支持开发时代码的热更新
    5. 支持代码的压缩打包

    简单介绍一下webpack的几个概念

    webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle。

    • 入口(entry)

    入口起点(entry point)指示 webpack 应该使用哪个模块,来作为构建其内部依赖图的开始。进入入口起点后,webpack 会找出有哪些模块和库是入口起点(直接和间接)依赖的

    • 出口(output)

    output 属性告诉 webpack 在哪里输出它所创建的 bundles,以及如何命名这些文件,默认值为 ./dist。基本上,整个应用程序结构,都会被编译到你指定的输出路径的文件夹中。你可以通过在配置中指定一个 output 字段,来配置这些处理过程。

    • loader

    loader 让 webpack 能够去处理那些非 JavaScript 文件(webpack 自身只理解 JavaScript)。loader 可以将所有类型的文件转换为 webpack 能够处理的有效模块,然后你就可以利用 webpack 的打包能力,对它们进行处理。

    • 插件(plugins)

    loader 被用于转换某些类型的模块,而插件则可以用于执行范围更广的任务。插件的范围包括,从打包优化和压缩,一直到重新定义环境中的变量。插件接口功能极其强大,可以用来处理各种各样的任务。

    • 模式(mode)

    通过选择 development 或 production 之中的一个,来设置 mode 参数,你可以启用相应模式下的 webpack 内置的优化

    文件目录结构

    首先我把代码的Git路径(见下)各位可以先clone下来体验一下,先npm install然后运行npm run dev就可以体验。
    webpackdemo源码的下载和体验地址
    这里讲解一下当前的文件夹目录结构

    dist/                            #build后的代码目录
    src/                             #源码的文件夹
      index.html                     #html的模板文件
      main.js                        #代码的入口文件
      style.less                     #less的入口文件
      style.css                      #css文件
    postcss.config.js                #postcss的配置文件(这里是配置autoprefixer)
    webpack.common.js                #用于存放和开发和发布都需要的webpack配置文件
    webpack.dev.js                   #用于存放开发需要的webpack配置文件
    webpack.prod.js                  #用于存放发布需要的webpack配置文件(压缩代码等)
    

    通用的一些配置

    入口和出口以及插件的一些解释

    entry: [
        './src/main.js',// 编译js的入口文件
        './src/style.less' // 编译less的入口文件
      ],
      output: { // 编译完成的js会放在dist文件夹下命名为bundle.js
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist')
      },
      plugins: [
        new CleanWebpackPlugin(['dist']), // 每次编译先删除旧的dist文件夹
        new HtmlWebpackPlugin({
            title: 'Production', // 用来生成页面的 title 元素
            inject: true, // 注入所有的资源到特定的 template 或者 templateContent 中,如果设置为 true 或者 body,所有的 javascript 资源将被放置到 body 元素的底部,'head' 将放置到 head 元素中
            template: './src/index.html', // 模板文件路径
        })
      ],
    

    开发和发布需要的一些单独的配置

    开发过程主要是要便于调试,同时代码的热更新以及调试的方便
    了解devServer更多参数(中文)
    了解devServer更多参数(官网)

    // 开发环境下的配置
    module.exports = merge(common, {
      devtool: 'inline-source-map', // 报错时方便调试
      mode: 'development', // 设置当前模式为开发模式
      devServer: { // 
        inline: true, // 在 dev-server 的两种不同模式之间切换。默认情况下,应用程序启用内联模式(inline mode)。这意味着一段处理实时重载的脚本被插入到你的包(bundle)中,并且构建消息将会出现在浏览器控制台
        hot: true, // 启用 webpack 的模块热替换特性
        openPage: '', // 当打开浏览器显示的页面
        publicPath: '', // 此路径下的打包文件可在浏览器中访问
        port: 3000, // 当前运行的端口
        historyApiFallback: true, // 当使用 HTML5 History API 时,任意的 404 响应都可能需要被替代为 index.html
        overlay: { // 展示编译的错误和警告
          warnings: true,
          errors:true
        }
      },
      plugins: [
        new webpack.NamedModulesPlugin(), // 当开启 HMR 的时候使用该插件会显示模块的相对路径
        new webpack.HotModuleReplacementPlugin() // 当开启 HMR 的时候使用该插件会显示模块的相对路径
      ]
    });
    
    // 生产环境下的配置
    module.exports = merge(common, {
      devtool: 'source-map', // 整个 source map 作为一个单独的文件生成。它为 bundle 添加了一个引用注释,以便开发工具知道在哪里可以找到它
      mode: 'production', // 设置当前模式为生产环境
      plugins: [
        new UglifyJSPlugin({ // 代码混淆
          sourceMap: true,
          uglifyOptions: {
            warnings: false,
            parse: {},
            compress: {
              warnings: false,
              drop_debugger: true,
              drop_console: true
            },
          }
        })
      ]
    });
    

    其他插件的配置

    这里主要是通过loader来实现的,loader功能非常强大。这里只介绍我在demo里使用到的一些loader。
    官网常用的一些loader

    1. 支持es6的语法
      使用的是babel-loader,具体代码见下:
    // 安装babel-loade
    npm install -D babel-loader @babel/core @babel/preset-env webpack
    // 配置
    module: {
      rules: [
        {
          test: /\.m?js$/,
          exclude: /(node_modules|bower_components)/,
          use: {
            loader: 'babel-loader',
            options: {
              presets: ['@babel/preset-env']
            }
          }
        }
      ]
    }
    
    
    1. css和less支持和autoprefixer
      这里用到了style-loadercss-loaderpostcss-loaderless-loaderautoprefixer。具体配置见代码(css其实也可以进行优化参考MiniCssExtractPlugin,有需要的同学可以参考文档优化):
    //安装
    npm install --save-dev style-loader css-loader postcss-loader less-loader autoprefixer
    
    // 以下css的webpack配置,同时需要将编译的css引入到js才会进行编译
    {
            test: /\.css$/,
            use: [
              'style-loader',
              'css-loader',
              {
                loader: 'postcss-loader',
                options: {
                  plugins: [
                    autoprefixer({
                      browsers: ['last 3 versions', '> 1%']
                    })
                  ]
                }
              }
            ]
          },
    // less的配置,同时要在webpack的entry配置less的入口文件
    {
            test: /\.less$/,
            use: [{
              loader: 'style-loader' // creates style nodes from JS strings
            }, {
              loader: 'css-loader' // translates CSS into CommonJS
            }, {
              loader: 'postcss-loader',
              options: {
                plugins: [
                  autoprefixer({
                    browsers: ['last 3 versions', '> 1%']
                  })
                ]
              }
            }, {
              loader: 'less-loader' // compiles Less to CSS
            }]
          }
    
    // autoprefixer需要新建postcss.config.js同时按下面配置
      module.exports = {
        plugins: [
          require('autoprefixer')
       ]
      }
    

    自己封装的一个react脚手架

    目前只封装了一个react的,vue的会在后面我会更新上来.
    基于webpack的react脚手架

    参考文档

    最后如果对本文章有疑问或者文章有错误欢迎在评论区指出

    相关文章

      网友评论

          本文标题:webpack4+配置的一个简单例子

          本文链接:https://www.haomeiwen.com/subject/cubxkqtx.html