webpack3.x 学习笔记

学习文章： http://jspang.com/2017/09/16/webpack3-2/
webpack文档： https://doc.webpack-china.org/concepts/

目录

  • 安装webpack

    npm 初始化

      npm init    // 需要输入项目名称、版本号、项目描述、作者等等..
  npm init -y // 选项都是默认内容，不用一个个输入，后续需要修改直接在package.json文件改就行了

    *注：npm在国内下载安装模块太慢，可以换成cnpm(淘宝npm镜像)

      npm install -g cnpm --registry=https://registry.npm.taobao.org

    本地安装

      npm install --save-dev webpack
  npm install --save-dev webpack@<version>

  //说明: --save代表把这个模块保存到package.json里面， -dev代表用于开发环境

    全局安装(不建议全局安装webpack,后面有坑)

      npm install --global webpack //安装
  npm uninstall webpack -g    // 卸载

    附：
    如果是最新版本4.5的话， 运行webpack -v 查询webpack版本号的时候，会显示是否安装 webpack-cli ,
    运行 npm install -D webpack-cli ，
    完成之后还是会报错，还是需要全局安装一下，在运行 npm install -g webpack-cli ，
    最后 webpack -v 版本号出来了，完美~

监听和入口出口

页面监听(古老方法，后续有webpack自带的服务介绍)

    // 简单粗暴型
    npm install live-server -g //全局安装
    live-server // 自动在浏览器打开查看，默认地址 http://127.0.0.1:8080

 2.2 基础打包

**无配置webpack.config.js文件**

3.x

    webpack src/entery.js dist/bundle.js
    // src/entery.js 入口文件
    // dist/bundle.js 出口文件

4.x

    webpack --mode=development  // 无配置webpack.config.js文件的情况下，借助webpack-cli
    // index.js 入口文件
    // main.js 出口文件 


**配置webpack.config.js**

只需要运行 `webpack` 即可打包成功

    const path = require('path');
    module.exports = {
        mode: 'development', // development(开发环境)或者production(生产环境)
        /* entry入口文件
         * entry 属性的单个入口语法,还有多个入口的，详情请看文档
        */
        entry: {
            entry: './src/entry.js'
        },

        // output 目标输出
        output: {
            path: path.resolve(__dirname, 'dist'), // 目标输出绝对路径
            filename: 'bundle.js'
        },
    }
 
---

  • 服务和热更新

    安装命令 npm install webpack-dev-server --save-dev

    在webpack.config.js里面配置服务devServer

      const config = {
      devServer: {
          contentBase: path.resolve(__dirname, 'dist'), //入口路径
          host: '192.168.1.106', // 本机ip地址
          compress: true, // 服务压缩，一般设置为true
          port: 9090  //端口，随便设置
      } 
  }

    在package.json文件里面配置简短别名

        "scripts": {
          "dev": "webpack-dev-server"  // 监听
      },
      // 注： 'webpack-dev-server --open'  是直接打开入口页面到浏览器

  • 打包css文件

    4.1 css打包

    style-loader 处理css文件中的url()等
    css-loader 将css插入到页面的style标签

      // css必须安装这两个loader
  cnpm install style-loader css-loader -D  // "-D"表示"--save-dev"

    loader配置，在wepack.congig.js文件下配置module

      const config = {
      module: {
          rules: [
              {
                  test: /\.css$/,
                  use: ['style-loader', 'css-loader']
              }
          ]
      }, 
  }

    loader还有以下的几种写法：

    1.上面写的，直接传递字符串组， loader 属性的简写方式
    2.把use换成loader

     const config = {
      module: {
          rules: [
              {
                  test: /\.css$/,
                  loader: ['style-loader', 'css-loader']
              }
          ]
      }, 
  }

    3.use + loader属性的写法

      const config = {
      module: {
          rules: [
              {
                  test: /\.css$/,
                  use: [
                      'style-loader',
                      {
                          loader: 'css-loader',
                          options: {
                              importLoaders: 1
                          }
                      }
                  ]
              }
          ]
      }, 
  }

    4.2 Less文件的打包和分离

    安装less

      cnpm i less -D // less服务
  cnpm i less-loader -D //loader打包使用

  // 一起安装
  cnpm i less less-loader -D

    loader配置
    webpack.config.js

      module: {
      rules: [
          {
              test: /\.less$/,
              use: [
                  {
                      loader: "style-loader"
                  },
                  {
                      loader: "css-loader"
                  },
                  {
                      loader: "less-loader"
                  }
              ]
          }
      ]
  },

    分离less插件

      cnpm i extract-text-webpack-plugin -D // 前面已安装过分离插件

    修改webpack.config.js

      module: {
      rules: [
          {
              test: /\.less$/,
              use: extractTextPlugin.extract({
                  use: [
                      {
                          loader: "css-loader"
                      },
                      {
                          loader: "less-loader"
                      }
                  ],
              fallback: "style-loader"
              })
          },
      ]
  }

    4.3 sass文件的打包和分离

    sass的配置和less的差不多

    安装模块

      cnpm i node-sass -D // sass-loader依赖no-sass,所以要先安装
  cnpm i sass-loader -D //loader打包使用

  // 一起安装
  cnpm i node-sass sass-loader -D

    loader配置
    webpack.config.js

      module: {
      rules: [
          {
              test: /\.scss$/,
              use: [
                  {
                      loader: "style-loader"
                  },
                  {
                      loader: "css-loader"
                  },
                  {
                      loader: "sass-loader"
                  }
              ]
          }
      ]
  },

    分离less插件

      cnpm i extract-text-webpack-plugin -D // 前面已安装过分离插件

    修改webpack.config.js

      module: {
      rules: [
          {
              test: /\.scss$/,
              use: extractTextPlugin.extract({
                  use: [
                      {
                          loader: "css-loader"
                      },
                      {
                          loader: "sass-loader"
                      }
                  ],
              fallback: "style-loader"
              })
          },
      ]
  }

    4.4 自动处理css3属性前缀

    PostCSS是一个css处理平台，可以帮助css实现更多功能，使用autoprefixr插件可以使PostCSS拥有自动添加前缀的功能。更多PostCSS相关操作查看它的github地址：https://github.com/postcss/postcss-loader;

    安装

      cnpm i postcss-loader autoprefixer -D

    在根目录新建一个postcss.config.js文件（与webpack.config.js同级）

      module.exports = {
      plugins: [
          require('autoprefixer')
      ]
  }

    在webpack.config.js里配置loader(打包和分离)

      module: {
      rules：[  
          {
              test: /\.css$/,
              use: extractTextPlugin.extract({
              fallback: 'style-loader',
              use: [
                  {
                      loader: 'css-loader',
                      options: {
                          importLoaders: 1
                      }
                  },
                  {
                      loader: 'postcss-loader'
                  }
              ]
              })
          },
      ]
  }

    4.5 消除未使用的css（减少css冗余）

    purifycss-webpack要依赖于purify-css,安装

    cnpm i purify-css purificss-webpack -D

    配置webpack.config.js

      const glob = require('glob'); // 引入node的glob对象，同步检测html模板，遍历文件，查找哪些css被使用了
  const purifyCSSPlugin = require('purifycss-webpack');

  plugins: [
      new extractTextPlugin('css/index.css'),
      new purifyCSSPlugin({
          paths: glob.sync(path.join(__dirname, 'src/*.html'))
      })
  ],

    注意：使用这个插件必须配合extract-text-webpack-plugin这个插件。

  • 压缩js代码

    引用webpack内置插件

      const uglifyPlugin = require('uglifyjs-webpack-plugin');

    在webpack.config.js配置插件

      const config = {
      plugins: [
          new uglifyPlugin()
      ],
  }

  • 打包html文件

    用cnpm安装包

      cnpm i html-webpack-plugin -D

    在webpack.config.js引用插件包

      const uglifyPlugin = require('uglifyjs-webpack-plugin');

    在webpack.config.js配置插件

      plugins: [
      new uglifyPlugin(),
      new htmlPlugin({
          minify:{ // minify对html文件进行压缩
              removeAttributeQuotes:true // 去掉html属性值里面的双引号("");
          },
          hash:true, // 加入哈希值避免缓存问题
          template:'./src/index.html' // 打包的html模板路径和文件名字
      
      })
  ],

  • 图片大坑

    7.1 CSS中的图片处理

    由于缺少loader对图片的解析，会在终端报错，如下图：

    图片

    所以需要安装loader

      cnpm i url-loader -D

    配置webpack.config.js文件

      const config = {
      module: {
          rules: [
              {
                  test: /\.(png|gif|jpg|svg|jpeg)$/,
                  use: [
                      {
                          loader: 'url-loader',
                          options: {
                              limit: 8192, // 把小于8192B的文件打成Base64的格式
                              outputPath:'images/ ' // 输出的图片路径
                          }
                      }
                  ]
              }
          ]
      },
  }

    url-loader： 内置有file-loader, 当在图片较多的情况下，会发送非常多的http请求，降低页面页面性能，url-loader就可以解决这个问题，url-loader会将引入的小图片编码，生成dataURl。相当于把图片数据翻译成一串字符。再把这串字符打包到文件中，最终只需要引入这个文件就能访问图片了。
    url-loader工作分为两种情况：

    1. 文件大小小于limit参数，url-loader会将文件转成dataUrl(base64g格式);
    2. 文件大小大于limit参数，url-loader会直接调用file-loader进行处理，参数也会传给file-loader。

    file-loader： 解决图片引用路径的问题，file-loader可以解析项目中的url引入（不仅限于css），它可以根据我们的配置，将图片拷贝到相应的路径，在修改打包后文件引用路径，使之指向正确文件。

    7.2 CSS分离与图片路径处理

    7.2.1 css分离插件

      cnpm i extract-text-webpack-plugin -D

    webpack.config.js中配置

      const extractTextPlugin = require('extract-text-webpack-plugin'); // 引入
  module.exports = {
      module: {
          rules: [
          {
              test: /\.css$/,
              use: extractTextPlugin.extract({
              fallback: "style-loader",
              use: "css-loader" //用于将资源转换成一个 CSS 导出模块
              })
          }
          ]
      },
      plugins: [
          new extractTextPlugin("css/index.css")
      ]
  }

    7.2.2 图片路径问题

    利用extract-text-webpack-plugin插件确实是可以把css完美分离出来，但是图片路径却不对，所以需要用到publicPath,在webpack.config.js里配置：

      // 声明website(本机ip或者是devServer设置的ip) **疑问？上线的项目咋整？**
  const website ={
      publicPath:"http://192.168.1.248:9090/"
  }
  module.exports = {
      output: {
          path: path.resolve(__dirname, 'dist'),
          filename: '[name].js',
          publicPath: website.publicPath
      }
  }

    7.3 处理HTML中的图片

    解决在hmtl文件中引入<img>标签的问题

      cnpm install html-withimg-loader --save-dev

    在webpack.config.js配置

      module: {
      rules: [
          {
              test: /\.(htm|html)$/i,
              use:['html-withimg-loader']
          }
      ]
  },

  • 增加babel支持（es6,es7语法转换）

    babel是一个编译javascript的平台，它可以通过编译达到以下目的：

    • 使用下一代的javascript代码（如es6,es7）,这些标准目前并未被当前浏览器完全支持；
    • 使用基于javascript进行扩展的语言，例如React的JSX.

    Babel的安装

    Babel是几个模块的包，其核心功能位于babel-core的npm包中。
    安装依赖包：（babel-preset-env解析es6）

      cnpm i babel-core babel-loader babel-preset-env -D

    在webpack.config.js中配置loader

      {
      test:/\.(jsx|js)$/,
      use:{
          loader:'babel-loader'
      },
      exclude:/node_modules/
  }

    .babelrc配置

      {
      "presets":["react","env"]
  }

    或者直接在webpack.config.js中配置babel,建议把babel配置分开到.babelrc文件，如上所述。

      module: {
      rules: [
          {
              test:/\.(jsx|js)$/,
              use:{
                  loader:'babel-loader',
                  options:{
                      presets:[
                          "es2015","react"
                      ]
                  }
              },
              exclude:/node_modules/
          }
      ]
  }

    babel-preset-es2015也可以解析es6,但是网上已经不流行了，官方推荐使用babel-preset-env.
    babel-preset-es2015的配置方法和babel-preset-env差不多，只要把env改为es2015

      {
      "presets":["env"]
  }

  • 常见报错集锦

    • 1.ip不正确或者端口被占用

      错误1

      *注：在这种情况下要注意检查本机Ip是否写正确，端口是否被占用。(查看本机ip方法, win+R打开运行 -> 输入cmd -> 执行ipconfig)

posted @ 2018-12-25 11:38  莯琂  阅读(171)  评论(0)    收藏  举报