webpack 之 零基础使用常用的Loader,超详细

目录

一、webpack的使用前提

二、项目初始化

1.创建webpack文件夹,进入文件夹后初始化

2.安装webpack (-D 安装开发依赖)

3.创建文件夹src

4.src下创建js 文件夹

5.js 文件夹创建math.js

6. js 文件夹创建format.js

7.src下创建index.js

8.以上所说的目录结构如此

三、JavaScript的打包

1.修改package.json

2.打包

3.为了看到效果,在最外层下创建index.html,运行即可

4.webpack目录下创建配置文件webpack.config.js

四、CSS的打包

1.在src下创建css文件夹,并在其中创建style.css

2.在index.js中导入 

3. 下载所需CSS的loader

4.在webpack.config.js文件中进行配置

五、less|sass的配置

1.在src下的css文件夹中创建text.less

2.在index.js中导入

3. 下载less的loader

4.在webpack.config.js文件中进行配置

六、PostCSS工具配置

1.下载postcss-loader

2.下载所需要的插件

3.在webpack.config.js文件中进行配置

4. 已经添加成功

 5.优化一下,可以把postcss的配置专门写到一个文件中

七、图片资源的打包(webpack5之前版本)

1.安装filer-loader,url-loader

2.在webpack.config.js中进行配置 

3.在src下创建img文件夹,往里加入测试图片text.png

4.在css文件夹中创建image.css

5.在js文件夹中创建element.js

6.在index.js中导入

7.打包一下即可

8.优化,打包后的文件位置和文件名不太优雅

八、图片资源的打包(webpack5之后版本) 

九、打包字体文件 

1.在src下创建font文件夹

2. 在element.js文件中,加入新的代码

3.使用的类名为

4.在webpack.config.js中进行配置


webpack是一个静态的模块化打包工具,为现代的javaScript应用程序

  • 打包bundler : webpack可以帮助我们进行打包
  • 静态的static : 我们可以将代码打包成最终的静态资源,部署到静态服务器
  • 模块化module : webpack支持各种模块化开发,ES Module . CommonJS . AMD 等
  • 现代的modern : 因为现代前端开发面临各种问题,才催生了webpack的出现和发展

我们可以编写左边的各种类型的代码,但是浏览器不能直接识别,所以需要打包工具对代码进行打包,生成可以被浏览器直接识别的静态资源(右边)


webpack是如何打包的呢

  • webpack会根据命令或者配置文件找到入口文件
  • 从入口开始,会生成一个依赖关系图,这个依赖关系图会包含应用程序中所需的所有模块(比如.js文件、css文件、图片、字体等)
  • 然后遍历图,打包一个个模块(根据文件的不同使用不用的loader来进行解析)

一、webpack的使用前提

因为webpack的运行时依赖Node环境,所以需要安装Node。下载 Node.js

注:安装好node后,npm就已经存在了


二、项目初始化

1.创建webpack文件夹,进入文件夹后初始化

npm init -y

2.安装webpack (-D 安装开发依赖)

npm install webpack webpack-cli -D

3.创建文件夹src

4.src下创建js 文件夹

5.js 文件夹创建math.js

//ES6的导出
export function sum(num1,num2){
    return num1 + num2
}

6. js 文件夹创建format.js

// CommonJs的导出
const priceFormat = function(){
    return '$99.88'
}
module.exports = {
    priceFormat
}

7.src下创建index.js

import { sum } from './js/math';
const { priceFormat } = require('./js/format');

console.log(sum(20, 30));
console.log(priceFormat());

8.以上所说的目录结构如此

三、JavaScript的打包

1.修改package.json

  "scripts": {
    "build":"webpack"
  },

2.打包(后续所有的打包,都是这个命令,就不再写了哈~~)

npm run build

3.为了看到效果,在最外层下创建index.html,运行即可

// 引用打包后的js文件
<body>
  <script src="./dist/main.js"></script>
</body>

以上为webpack默认指定的入口和出口,下面手动配置

4.webpack目录下创建配置文件webpack.config.js

简单来说,通过webpack来打包,需要指定一个入口,指定出口

入口:需要打包的文件都要放在入口处,没放进来的不会被打包

出口:经过打包后的文件所放的地方

const path = require('path'); // 需要使用 Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    path: path.resolve(__dirname, './dist'), 
    // 打包后的js的文件名
    filename: 'boundle.js' 
  }
};

四、CSS的打包

1.在src下创建css文件夹,并在其中创建style.css

body{
  background-color: skyblue;
  /* 下面测试postcss用 */ 
  user-select: none; 
}

2.在index.js中导入 

import './css/style.css';

3. 下载所需CSS的loader

loader : 可以用于对模块的源代码进行转换

因为webpack默认只能打包js,如果需要打包其他模块(例如css),需要下载对应loader

css-loader : 负责将.css文件进行解析,但并不会讲解析后的css插入到页面中

style-loader : 完成页面插入css操作

npm install css-loader style-loader -D

4.在webpack.config.js文件中进行配置

const path = require('path'); // Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    path: path.resolve(__dirname, './dist'), 
    // 打包后的js的文件名
    filename: 'boundle.js' 
  },
  // 配置模块
  module: {
    // 规则
    rules: [
      {
        // 用正则表达式来进行匹配,匹配css文件
        test: /\.css$/, 
        // 使用的loader。注:这里执行顺序是从右往左走|从下往上,先解析,再插入
        use: ['style-loader', 'css-loader'] 
      }
    ]
  }
};

五、less|sass的配置

前提是下载了less|scss哦,以下已less为栗子,sass下载对应的包即可

npm install less -D

1.在src下的css文件夹中创建text.less

@textColor:blue;

body{
  color: @textColor;
}

小tip : 如果使用vscode,可以安装插件 Easy LESS ,当保存less文件内容时,会自动生成对应的css文件,方便观看,不下载亦可

2.在index.js中导入

import './css/text.less'

3. 下载less的loader

npm install less-loader -D

4.在webpack.config.js文件中进行配置

const path = require('path'); // Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    path: path.resolve(__dirname, './dist'), // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    filename: 'boundle.js' // 打包后的js的文件名
  },
  // 配置模块
  module: {
    // 规则
    rules: [
      {
        test: /\.css$/, // 用正则表达式来进行匹配,匹配css文件
        use: ['style-loader', 'css-loader'] // 使用的loader
      },
      {
        test: /\.less$/, // 用正则表达式来进行匹配,匹配less文件
        use: ['style-loader', 'css-loader', 'less-loader'] // 使用的loader
      }
        
      // -------css和less的配置可以合并,如下-------
      
      {
        test: /\.(css|less)$/, // 用正则表达式来进行匹配,匹配css|less文件
        use: ['style-loader', 'css-loader', 'less-loader'] // 使用的loader
      }
      
    ]
  }
};

六、PostCSS工具配置

PostCSS : 

  • 是一个通过JavaScript来转换样式的工具
  • 可以帮助我们进行一些CSS的转换和适配,如自动添加浏览器前缀,css样式的重置

使用PostCSS : 

  1. 查找PostCSS在构建工具中的扩展,比如webpack中的postcss-loader
  2. 选择可以添加所需要的PostCSS相关的插件 

1.下载postcss-loader

npm install postcss-loader -D

2.下载所需要的插件

autoprefixer : 自动添加浏览器前缀

postcss-preset-env : 将现代的css特性转为大多数浏览器可识别的css,自动添加浏览器前缀

所以,直接用下面辣个插件即可

npm install postcss-preset-env -D

3.在webpack.config.js文件中进行配置

const path = require('path'); // Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    path: path.resolve(__dirname, './dist'), // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    filename: 'boundle.js' // 打包后的js的文件名
  },
  // 配置模块
  module: {
    // 规则
    rules: [
      {
         test: /\.(css|less)$/, // 用正则表达式来进行匹配,匹配css|less文件
        use: [
          'style-loader',
          'css-loader',
          // 使用postcss
          {
            loader: 'postcss-loader',
            options: {
              postcssOptions: {
                plugins: [require('postcss-preset-env')]
              }
            }
          },
          'less-loader' // 先把less转换,然后再用这个插件会好点
        ]
      }
    ]
  }
};

4. 已经添加成功

 5.优化一下,可以把postcss的配置专门写到一个文件中

在目录下新建postcss.config.js文件

module.exports = {
  plugins: [require('postcss-preset-env')]
};

那么 webpack.config.js只要这么写即可

const path = require('path'); // Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    path: path.resolve(__dirname, './dist'), // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    filename: 'boundle.js' // 打包后的js的文件名
  },
  // 配置模块
  module: {
    // 规则
    rules: [
      {
        test: /\.(css|less)$/, // 用正则表达式来进行匹配,匹配css|less文件
        use: ['style-loader', 'css-loader', 'postcss-loader', 'less-loader'] // 使用的loader
      }
    ]
  }
};

七、图片资源的打包(webpack5之前版本

注:这里说的是webpack5之前的版本所使用的 , 否则可能报错

webpack5中file-loader和url-loader都不怎么使用了

要处理jpg、png等格式的图片,也需要有对应的loader

file-loader : 作用是帮助我们处理import\require()方式引入的文件资源,并放到我们输出的文件夹中,不管大小都输出文件

url-loader : 和file-loader工作方式是相似的,不过可以将较小的图片转成base64的URI

两个使用其中一个即可

1.安装filer-loader,url-loader

npm install file-loader url-loader -D

2.在webpack.config.js中进行配置 

const path = require('path'); // Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    path: path.resolve(__dirname, './dist'), // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    filename: 'boundle.js' // 打包后的js的文件名
  },
  // 配置模块
  module: {
    // 规则
    rules: [
      {
        test: /\.(css|less)$/, // 用正则表达式来进行匹配,匹配css|less文件
        use: ['style-loader', 'css-loader', 'postcss-loader', 'less-loader'] 
      },
      {
        test: /\.(png|jpe?g|gif|svg)$/i, // 用正则表达式来进行匹配,匹配以这些后缀名的图片
        use: [
          {
            loader: 'file-loader',
            options: {
              // 高版本的file-loader不这样配置的话,img的src为[object Module]
              esModule: false
            }
          },

          /// -----------------使用其中一个即可

          {
            loader: 'url-loader',
            options: {
              // 高版本的file-loader不这样配置的话,img的src为[object Module]
              esModule: false
            }
          }
        ] 
      }
    ]
  }
};

3.在src下创建img文件夹,往里加入测试图片text.png

4.在css文件夹中创建image.css

.div-dom{
  width: 100%;
  height: 500px;
  background: url('../img/text.png')  ;    
}

5.在js文件夹中创建element.js

// 导入css样式
import '../css/image.css';

import imgUrl from '../img/text.png';

// 创建一个div元素 , 设置背景图片
const divDom = document.createElement('div');
// 赋值一个class
divDom.className = 'div-dom';
// 加入到body中
document.body.appendChild(divDom);

// 创建一个img元素 , 设置src
const imgDom = document.createElement('img');
// 注意,不能这样赋值,这样相当于赋值了个字符串,到时候页面会从相对路径去找图片,是找不到的
// imgDom.src = '../img/text.png';

// 赋值src,相当于导入一个模块
imgDom.src = imgUrl;
// 加入到body中
document.body.appendChild(imgDom);

6.在index.js中导入

import './js/element';

7.打包一下即可

file-loader打包结果如下

如果使用url-loader打包的,可能没有生成图片,小图片会在boundle.js中以base64形式存在,望周知 

8.优化,打包后的文件位置和文件名不太优雅

  • 要保留原来的文件名、扩展名,同时为了防止重复,包含一个hash值
  • 可以使用PlaceHolders有很多,可以查阅下文档 file-loader ,前几个都比较常用
const path = require('path'); // Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    path: path.resolve(__dirname, './dist'), // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    filename: 'boundle.js' // 打包后的js的文件名
  },
  // 配置模块
  module: {
    // 规则
    rules: [
      {
        test: /\.(css|less)$/, // 用正则表达式来进行匹配,匹配css|less文件
        use: ['style-loader', 'css-loader', 'postcss-loader', 'less-loader'] 
      },
      {
        test: /\.(png|jpe?g|gif|svg)$/i, // 用正则表达式来进行匹配,匹配以这些后缀名的图片
        use: [
          {
            loader: 'file-loader',
            options: {
              // 高版本的file-loader不这样配置的话,img的src为[object Module]
              esModule: false,
              // 打包后会有个img文件夹
              outputPath:'img',
              // 保留名字,加上6位hash值,保留扩展名
              name:"[name]__[hash:6].[ext]"
            }
          }

          //----------使用一个即可

          {
            loader: 'url-loader',
            options: {
              // 高版本的file-loader不这样配置的话,img的src为[object Module]
              esModule: false,
              // 设置当小于100kb的图片打包成base64,大于的打包成图片输出到img文件夹中
              limit: 100 * 1024,
              // 打包后会有个img文件夹
              outputPath: 'img',
              // 保留名字,加上6位hash值,保留扩展名
              name: '[name]__[hash:6].[ext]'
            }
          }

        ] 
      }
    ]
  }
};

八、图片资源的打包(webpack5之后版本 

webpack5之前 :  加载这些资源需要使用一些loader,比如url-loader、file-loader

webpack5之后 : 直接使用资源模块类型( asset module type ),来替代上面的loader

  • asset / resource : 发送一个单独的文件并导出URL,之前是使用 file-loader
  • asset / inline : 导出一个资源的data URI ,之前是使用 url-loader
  • asset / source : 导出资源的源代码 ,之前是使用 raw-loader
  • asset : 在导出一个data URI 和 发送一个单独文件之间自动选择,之前是通过使用 url-loader,并且配置资源体积限制( limit )来实现

你会发现更简单啦,不用下载loader

const path = require('path'); // Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    path: path.resolve(__dirname, './dist'), // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    filename: 'boundle.js' // 打包后的js的文件名
  },
  // 配置模块
  module: {
    // 规则
    rules: [
      {
        test: /\.(css|less)$/, // 用正则表达式来进行匹配,匹配css|less文件
        use: ['style-loader', 'css-loader', 'postcss-loader', 'less-loader']
      },
      {
        test: /\.(png|jpe?g|gif|svg)$/i, // 用正则表达式来进行匹配,匹配以这些后缀名的图片
        // 自动选择
        type: 'asset',
        parser: {
          // 数据url的条件配置
          dataUrlCondition: {
            // 超过100kb的图片打包,小于的弄成bast64
            maxSize: 100 * 1024
          }
        },
        // 生成
        generator: {
          outputPath: 'img',
          filename: '[name]__[hash:8][ext]',

          // 以上这两个属性可以合在一起

          filename: 'img/[name]__[hash:8][ext]'
        }
      }
    ]
  }
};

九、打包字体文件 

首先得现有字体文件,我是在阿里矢量图标库中下载的 iconfont-阿里巴巴矢量图标库

把选中的图标添加到自己的项目,下载下来即可

1.在src下创建font文件夹

2. 在element.js文件中,加入新的代码

// 导入字体的css
import '../font/iconfont.css';

const iDom = document.createElement('i');
// 使用下载的字体图标,注意使用方法
iDom.className = 'iconfont icon-icon_tianjia';
document.body.appendChild(iDom);

3.使用的类名为

4.在webpack.config.js中进行配置

const path = require('path'); // Node内置模块

module.exports = {
  // 入口
  entry: './src/index.js',
  // 出口
  output: {
    path: path.resolve(__dirname, './dist'), // 因为这里需要绝对路径,__dirname获取到的是当前文件所在路径,所以拼接一下
    filename: 'boundle.js' // 打包后的js的文件名
  },
  // 配置模块
  module: {
    // 规则
    rules: [
      {
        test: /\.(css|less)$/, // 用正则表达式来进行匹配,匹配css|less文件
        use: ['style-loader', 'css-loader', 'postcss-loader', 'less-loader']
      },
      {
        test: /\.(png|jpe?g|gif|svg)$/i, // 用正则表达式来进行匹配,匹配以这些后缀名的图片
        // 自动选择
        type: 'asset',
        parser: {
          // 数据url的条件配置
          dataUrlCondition: {
            // 超过100kb的图片打包,小于的弄成bast64
            maxSize: 100 * 1024
          }
        },
        // 生成
        generator: {
          filename: 'img/[name]__[hash:8][ext]'
        }
      },
      {
        test: /\.(eot|ttf|woff2?)$/i, // 用正则表达式来进行匹配,匹配以这些后缀名的字体文件
        type: 'asset/resource',
        // 生成
        generator: {
          filename: 'font/[name]__[hash:8][ext]'
        }
      }
    ]
  }
};

猜你喜欢

转载自blog.csdn.net/a15297701931/article/details/124611698