webpack安装与使用(详细)

Posted 远方有只兔子~

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了webpack安装与使用(详细)相关的知识,希望对你有一定的参考价值。

一.什么是webpack?

webpack是现代javascript应用程序的静态模块打包器,当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle。
webpack更加强调模块化开发管理,文件压缩、预处理等功能,是它附带的功能。
注意:

  • webpack模块化打包webpack为了可以正常运行, 必须依赖node环境,
  • node环境为了可以正常执行很多代码,又必须依赖各种包,
  • 依赖各种包就需要npm工具(node packages manager node包管理 )

二、webpack安装

安装webpack ,要先安装node.js node.js自带了软件包管理工具npm
1.查看node版本(node的安装自行查找,很简单)

node -v

2.全局安装webpack,避免后面出现版本问题,提前指定版本

npm install webpack@3.6.0 -g

注意:在此处进行全局安装后,后面也会进行局部安装

  • 为什么全局安装后,还需要进行局部安装呢?
    一个项目往往依赖特定的webpack版本,全局的版本可能和这个项目的webpack版本不一致,导致打包出现问题。所以通常一个项目,都有自己的局部的webpack, webpack@3.6.0方便查看配置文件,后面的版本把配置文件隐藏起来了

创建了项目之后在项目文件夹下安装局部:(下面就是在webpacklearn文件夹下安装)

npm install webpack@3.6.0 --save-dev

–save-dev是开发时依赖。项目打包后不需要再使用的

三、webpack使用

(1)新建项目webpacklearn,按下图依次创建文件夹:

!!!!如果项目中依赖node中的一些包 ,npm init运行建package.json

npm init
  • dist文件夹:用于存放打包的文件
  • src文件夹:用于存放我们写的源文件
    main.js:项目的入口文件
    test.js、test2.js 定义一些变量函数,可以在其他地方引用并且使用
  • index.html:浏览器打开展示的首页html
  • package.json:通过npm init生成的,npm包管理的文件

安装局部webpack:

npm install webpack@3.6.0 --save-dev

test.js test2.js 中的内容都要导出到main.js(主文件)中:(下面的代码中分别使用ES6的导入方式与commonJS的导入方式)

//test.js

function add(num1, num2) 
  return num1 + num2


function mul(num1, num2) 
  return num1 * num2


// commomJS方式导出方式 module.exports = 
module.exports = 
  add,
  mul

//test2.js

//ES6的导出方式 export
export const name = 'why';
export const age = 18;
//main.js文件
const add,mul = require('./test.js')
// (1)commonJS方式导入

console.log(add(20, 30));
console.log(mul(20, 30))

//(2) ES6方式导入 
import 
  name,
  age,
  height
 from './test2'

console.log(name);
console.log(age);
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
  <div>
    你好哦
  </div>
 <script src="./dist/bundle.js"></script>
</body>
</html>

进行打包:将项目文件夹在集成终端中打开,输入命令:

webpack ./src/main.js ./dist/bundle.js

npm init

一路回车,运行完成后自动创建package.json文件

新建 webpack.config.js

//webpack.config.js与index.html同级

const path = require('path');
//需要使用包  npm init生成package.json文件

module.exports = 
  entry: './src/main.js', //入口
  output: 
    path: path.resolve(__dirname, 'dist'), //动态获取路径,需要使用包path,   __dirname node中的全局变量
    filename: 'bundle.js'
  , //出口

-每次执行都敲这么长一串会不方便:

我们可以在package.json的scripts中定义自己的执行脚本
package.json中的script脚本在执行时,会按照一定的顺序寻找命令对应的位置,
首先,会寻找本地的node_modules/bin路径中对应的命令
如果没有找到,会去全局的环境变量中寻找

简化命令:修改:在项目文件夹下输入webpack的时候完成打包
webpack命令完成打包:

如何执行我们的build指令呢?–》
再次将打包命令修改命令为 npm run build,修改package.json文件 添加

"build": "webpack"



关于使用全局webpack还是局部webpack的问题?
打开文件在终端直接执行webpack命令,使用的全局安装的webpack
当在package.json中定义了scripts时,其中包含了webpack命令,以及npm run build命令,那么使用的是局部webpack(使用package.json中的script的脚本在执行时,会按照一定的顺序寻找命令对应的位置,如果没有找到,会去全局的环境中寻找,)

四、loader

在上面的代码中,我们主要是用webpack来处理我们写的js代码,并且webpack会自动处理js之间的相关的依赖。但是,在开发中我们不仅仅有基本的js代码处理,我们也需要加载css/图片,也包括一些高级的将ES6 转为ES5代码,将TypeScript转为ES5代码,将scss/less转为css,将.jsx、.vue文件转为js文件等等
对于webpack本身的能力来说,对于这些转化是不支持的;
给webpack扩展对应的loader就可以啦!
loader使用过程:

  • 步骤一:通过npm安装需要使用的loader

  • 步骤二:在webpack.config.js中的modules关键字下进行配置

loader中文文档:https://www.webpackjs.com/loaders/css-loader/#%E5%AE%89%E8%A3%85

五、 webpack中使用css文件的配置

新建css文件夹,以及文件normal.css,修改一下上面的文件:(修改main.js里面的导入路径)

body
  /* background-color:rgb(36, 114, 118); */
  background-image: url('../img/girl.jpg');

main.js中添加导入css

// 依赖css模块 
require('./css/normal.css')

安装css-loader

npm install --save-dev css-loader@0.23.1

安装style-loader
css-loader只负责将css文件进行加载
style-loader负责将样式添加到dom中

npm install style-loader@0.23.1 --save-dev

配置:webpack.config.js
注意:使用多个loader时,是从右向左使用

//webpack.config.js与index.html同级

const path = require('path');
//需要使用包  npm init生成package.json文件

module.exports = 
  entry: './src/main.js', //入口
  output: 
    path: path.resolve(__dirname, 'dist'), //动态获取路径,需要使用包path,   __dirname node中的全局变量
    filename: 'bundle.js'
  , //出口
  module:
    rules:[
      
        // 正则表达式 匹配所有的css文件,css-
        test:/\\.css$/,
        // css-loader只负责将css文件进行加载
        //style-loader负责将样式添加到DOM中
        //使用多个loader时,是从右向左使用
        use:['style-loader','css-loader']
      
    ]
  

打包测试样式能否正确显示样式,npm run build

六、webpack中使用less文件的配置

在css下面新建special.less文件:

@fontSize:50px;
@fontColor:orange;

body 
  font-size: @fontSize;
  color:@fontColor;

main.js

//依赖less文件:
require('./css/special.less')

安装:

npm install --save-dev less-loader@5.0.0 less@3.9.0

配置:webpack.config.js

      
        test:/\\.less$/,
        use:['style-loader','css-loader','less-loader']
      

打包测试:npm run build

七、webpack中图片文件处理的配置

增加img文件夹,添加一张图片,之后在css中引用,找得图片大小要小一些

引用:

安装:

npm install --save-dev url-loader@1.1.2

添加配置: limit先设置成比9.33*1024大的数字,此时图片处理时使用的是url-loader

      
        test: /\\.(png|jpg|gif)$/,
        use: [
          
            loader: 'url-loader',
            options: 
                //当加载的图片小于limit时,会将图片编译成base64字符串形式
              limit: 13000
              //大于limit之后,就需要使用file-loader模块加载了
            
          
        ]
        

测试:npm run build 背景正常显示:

修改limit的值小于9.77*1024 ,让其使用file-loader,比如设置成8000

在进行打包就会发现提示下面的错误,表示没有file-loader

安装:file-loader安装完后不用配置就可以使用

npm install --save-dev file-loader@3.0.1

安装上述所有内容的时候都要注意版本,如果安装过程中出现错误,首先检查自己的版本是否对应,在package.json中都可以看到安装内容的版本

安装完成后打包,发现背景图不能正常显示,

路径有问题,当使用file-loader之后,会在dist文件夹中生成32位哈希值名字的图片


图片文件处理-修改文件名字:webpack自动生成的名字是一个32位的哈希值,目的是防止名字重复,
所以,我们可以在opation中添加如下选项:

  • img:文件要打包到的文件夹
  • name:获取图片原来的名字,放在该位置
  • hash8:为了防止图片命名冲突,依然使用hash,但是我们只保留8位
  • ext:使用图片原来的扩展名
      
        test: /\\.(png|jpg|gif|jpeg)$/,
        use: [
          loader: 'url-loader',
          options: 
            limit: 8000,
            name: 'img/[name].[hash:8].[ext]'
          
        ]
      ,

npm run build:生成的图片名称是我们所设置的名称,

正常显示

(未完。。。)

webpack超详细配置, 使用教程(图文)

webpack超详细配置, 使用教程(图文)

博主在这里就不详细介绍webpack来源以及作用了, 本篇博文面向新手主要说明如何配置webpack, 以及webpack的使用方法, 直到创建出一个合理的属于自己webpack项目;

流程

webpack安装

  • Step 1: 首先安装Node.js, 可以去Node.js官网下载.

  • Step2: 在Git或者cmd中输入下面这段代码, 通过全局先将webpack指令安装进电脑中
    npm install webpack -g

  • Step3: 使用Git Bash here 或者 cmd cd命令使当前目录转到当前项目的目录下, 然后输入下面这段命令
    npm init
    技术分享
    接下来会弹出一些信息, 就是一些项目名和一些参数的描述, 可以全部按回车使用默认信息, 完成之后项目文件夹下会生成一个package.json的文件
    技术分享
    这样webpack就安装完成了.




webpack配置

  • Step1: 创建项目文件夹, 名字自起, 但路径名不要包含中文, 以及项目名也不要叫”webpack”, 并且不要包含大写字母.
    例:技术分享
  • Step2: 接下来创建并编写配置文件. 首先我们先介绍几个配置文件的参数.
    • entry: 是 页面入口文件配置 (html文件引入唯一的js 文件)
    • output:对应输出项配置
      • path :入口文件最终要输出到哪里,
      • filename:输出文件的名称
      • publicPath:公共资源路径
  • Step3: 在你的项目目录下创建webpack.config.js配置文件, 通过这个文件进行webpack的配置, 并且还要创建一些路径保存基本文件. 例如:
    技术分享
    src文件夹
    技术分享
  • Step4: 在src的js下创建一个入口文件, 我创建的叫做entry.js, 在项目目录再创建一个index.html用来调试使用. 编写webpack.config.js文件,

    //webpack.config.js
    module.exports = {
        entry : ‘./src/js/entry.js‘,//入口文件
        output : {//输出文件
            filename : ‘index.js‘,//输出文件名
            path : __dirname + ‘/out‘//输出文件路径
        },
    }

    我们随便在index.html和入口文件entry.js写点什么看看是否成功配置,

    //index.html
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8" />
        <title>ss</title>
    </head>
    <body>
    111
        <script src="./out/index.js"></script>//注意在这里引入的是打包完成的js文件
    </body>
    </html>
    //entry.js
    console.log(‘1234‘);

    之后使用Git Bash here 或者 cmd cd命令使目录为当前项目目录, 输入webpack或者webpack -w命令, 查看index.html是否成功console出1234;

webpack 和 webpack -w 区别
webpack -w可以对项目打包并且实时监控, 当前配置文件下的文件如果发生更改时重新打包, 但如果webpack的配置文件即webpack.config.js更改时还是要通过webpack进行打包.(退出webpack -w 操作 ctrl+c)


 webpack loader加载器

接下来我们继续配置loader, 通过加载器处理文件:比如 sass less 等, 告知 webpack 每一种文件都需要使用什么加载器来处理。

  • Step1: 为了方便我们先统一把所有的包都先下载下来, 下面再慢慢解释.

    npm install babel-loader babel babel-core css-loader style-loader  url-loader file-loader less-loader less  --save-dev
    

     

  • Step2: 下载完成后, 我们修改webpack.config.js文件, 将加载器引入.

    module.exports = {
        entry :  ‘./src/js/entry.js‘,
        output : {
            filename : ‘index.js‘,
            path : __dirname + ‘/out‘
        },
        module : {
            rules: [
                {test: /.js$/, use: [‘babel-loader‘]},
                {test: /.css$/, use: [‘style-loader‘, ‘css-loader‘]},/*解析css, 并把css添加到html的style标签里*/
                //{test: /.css$/, use: ExtractTextPlugin.extract({fallback: ‘style-loader‘,use: ‘css-loader‘})},/*解析css, 并把css变成文件通过link标签引入*/
                {test: /.(jpg|png|gif|svg)$/, use: [‘url-loader?limit=8192&name=./[name].[ext]‘]},/*解析图片*/
                {test: /.less$/, use: [‘style-loader‘, ‘css-loader‘, ‘less-loader‘]}/*解析less, 把less解析成浏览器可以识别的css语言*/
            ]
        },
        }

     

  • Step3: 接下来我们先测试css, 我们在项目文件夹下的src文件夹下创建index.css. 随便写一点属性.

    //index.css
    .demo1 {
        width: 100px;
        height: 100px;
        background: red;
    }
    .demo2 {
        width: 200px;
        height: 200px;
        background: orange;
    }
    //index.html
    <!DOCTYPE html>
    <html lang="en">
    <head>
    <meta charset="UTF-8" />
    <title>text</title>
    </head>
    <body>
    <div class="demo1"></div>
    <div class="demo2"></div>
    <script src="./out/index.js"></script>
    </body>
    </html>

    因为在webpack中所有文件都是模块, 所以必须要将css引入. 在刚刚的entry.js中添加如下代码.

    //entry.js
    require(‘../css/index.css‘);//引入css文件
    console.log("1234");

    打包webpack一下看看效果
    技术分享

  • Step4: 当有多个js文件时, 如何进行引入呢? 接下来我们做一个简单小功能来说明这个问题, 让我们点击方块的时候, 方块变大.

    接下来在src的js文件夹下创建一个基本的工具tool.js (很多小的问题都被我扩大化了, 只是为了说明问题不一定适用)

    //tool.js
    var tool = {//获取DOM元素
        getDom: function(className) {
            return document.getElementsByClassName(className)[0];
        }
    }
    
    module.exports = tool;//模块出口

    src的js下创建一个demo1.js文件, demo2.js同理

    var obj = require(‘./tool.js‘);
        var demo1 = {
        init: function() {
            this.bindEvent();
        },
        bindEvent: function() {
            //var demo1 = document.getElementsByClassName(‘demo1‘)[0];
            var demo1 = obj.getDom(‘demo1‘);
            demo1.onclick = this.changeStyle;
        },
        changeStyle: function() {
            this.style.width = ‘200px‘;
            this.style.height = ‘200px‘;
            this.style.background = ‘green‘;
            console.log(‘1‘);
        }
    }
    
    module.exports = demo1;

    修改入口文件entry.js

    require(‘../css/index.css‘);
    
    var demo1 = require(‘../js/demo1.js‘);
    var demo2 = require(‘../js/demo2.js‘);
    
        demo1.init();
        demo2.init();

    webpack一下, 看看效果
    技术分享

 


关于图片的打包

  • Step1: 在img文件夹下随便找一个小一点的图片放进去.
  • Step2: 修改entry.js

    require(‘../css/index.css‘);
    
    var demo1 = require(‘../js/demo1.js‘);
    var demo2 = require(‘../js/demo2.js‘);
    
        demo1.init();
        demo2.init();
    
    var oImg = new Image();
    oImg.src = require(‘../img/1.gif‘);//当成模块引入图片
    document.body.appendChild(oImg);

    由于我们引入的是静态资源, 在webpack.config.js中修改一下

    module.exports = {
            entry :  ‘./src/js/entry.js‘,
            output : {
                filename : ‘index.js‘,
                publicPath: __dirname + ‘/out‘,//添加静态资源, 否则会出现路径错误
                path : __dirname + ‘/out‘
            },
            module : {
                rules: [
                    {test: /.js$/, use: [‘babel-loader‘]},
                    {test: /.css$/, use: [‘style-loader‘, ‘css-loader‘]},/*解析css, 并把css添加到html的style标签里*/
                    //{test: /.css$/, use: ExtractTextPlugin.extract({fallback: ‘style-loader‘,use: ‘css-loader‘})},/*解析css, 并把css变成文件通过link标签引入*/
                    {test: /.(jpg|png|gif|svg)$/, use: [‘url-loader?limit=8192&name=./[name].[ext]‘]},/*解析图片*/
                    {test: /.less$/, use: [‘style-loader‘, ‘css-loader‘, ‘less-loader‘]}/*解析less, 把less解析成浏览器可以识别的css语言*/
                ]
            },
    }

    大家自己webpack看看效果

 


webpack进阶设定

我们在项目中有多个html文件时怎么处理呢?, 接下来我们重新设定配置文件, webpack.config.js

    module.exports = {
            entry : {index1: ‘./src/js/entry.js‘, index2: ‘./src/js/entry2.js‘},
        output : {
                filename : ‘[name].js‘,//这样就可以生成两个js文件, 名字分别为index1.js, 和index2.js
                publicPath: __dirname + ‘/out‘,//添加静态资源, 否则会出现路径错误
                path : __dirname + ‘/out‘
            },
            module : {
                rules: [
                    {test: /.js$/, use: [‘babel-loader‘]},
                    {test: /.css$/, use: [‘style-loader‘, ‘css-loader‘]},/*解析css, 并把css添加到html的style标签里*/
                    //{test: /.css$/, use: ExtractTextPlugin.extract({fallback: ‘style-loader‘,use: ‘css-loader‘})},/*解析css, 并把css变成文件通过link标签引入*/
                    {test: /.(jpg|png|gif|svg)$/, use: [‘url-loader?limit=8192&name=./[name].[ext]‘]},/*解析图片*/
                    {test: /.less$/, use: [‘style-loader‘, ‘css-loader‘, ‘less-loader‘]}/*解析less, 把less解析成浏览器可以识别的css语言*/
                ]
            },
    }

 


webpack插件使用

首先我们由于要使用webpack插件, 因此我们要重新下载一下webpack包, 将目录定位到当前项目目录, 输入npm install webpack
之后我们修改webpack.config.js, 将下面代码放到配置文件开头. 这样就可以使用插件了

var webpack = require(‘webpack‘);

将插件信息写到配置文件里

var webpack = require(‘webpack‘);
var uglifyPlugin = new webpack.optimize.UglifyJsPlugin({minimize: true});//代码压缩

var CommonsChunkPlugin = new webpack.optimize.CommonsChunkPlugin(‘common‘);//把公共模块提取出来, 并取名为‘common‘(名字自起), webpack之后再out文件夹下生成common.js, 测试时记得引入提取出来的公共模块js文件

var ExtractTextPlugin = require("extract-text-webpack-plugin");//将css独立引入变成link标签形式, 使用该插件需要独立下载‘npm install extract-text-webpack-plugin --save-dev‘, 同时下面的rules也必须更改

var providePlugin = new webpack.ProvidePlugin({$: ‘jquery‘, jQuery: ‘jquery‘, ‘window.jQuery‘: ‘jquery‘});//引入jquery



module.exports = {
    entry : {index: ‘./src/js/entry.js‘, index2: ‘./src/js/entry2.js‘},
    output : {
        filename : ‘[name].js‘,
        publicPath: __dirname + ‘/out‘,
        path : __dirname + ‘/out‘
    },
    module : {
        rules: [
            {test: /.js$/, use: [‘babel-loader‘]},
            //{test: /.css$/, use: [‘style-loader‘, ‘css-loader‘]},
            {test: /.css$/, use: ExtractTextPlugin.extract({fallback: ‘style-loader‘,use: ‘css-loader‘})},
            {test: /.(jpg|png|gif|svg)$/, use: [‘url-loader?limit=8192&name=./[name].[ext]‘]},
            {test: /.less$/, use: [‘style-loader‘, ‘css-loader‘, ‘less-loader‘]}
        ]
    },
    plugins: [uglifyPlugin, CommonsChunkPlugin, new ExtractTextPlugin(‘[name].css‘),providePlugin]//插件集合
}

 


webpack服务器

首先先定位目录输入命令 npm install webpack-dev-server -g
, 修改webpack.config.js文件

publicPath: ‘http://localhost:8080/out‘,

html文件所引用的目录也要更改:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8" />
    <title>text</title>
     <link rel="stylesheet" href="http://localhost:8080/out/index.css">
</head>
<body>
    <a href="http://localhost:8080/index2.html">11</a>
    <div class="demo1"></div>
    <div class="demo2"></div>
    <script src="http://localhost:8080/out/common.js"></script>
    <script src="http://localhost:8080/out/index.js"></script>
</body>
</html>

webpack-dev-server一下看看效果

小工具: webpace-dev-server –devtool eval-source-map –progess –colors打包时输入这一行可以直接找到文件如果出错时的位置

小知识点: 上面这一句话如果觉得太长可以将

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "xuan": "webpack-dev-server --devtool eval-source-map --progress --colors"
  },

这一段代码放到项目目录下的package.json里, 这样调试时如果输入npm run xuan就等于输入那一长串代码






















以上是关于webpack安装与使用(详细)的主要内容,如果未能解决你的问题,请参考以下文章

webpack 超详细配置,使用教程(图文)

Webpack 入门教程

超详细使用webpack4.x搭建标准前端项目

Webpack 入门教程

Webpack 入门教程

webpack超详细配置, 使用教程(图文)