说说如何配置 Webpack

1 基本配置

Webpack 最关键的就是 webpack.config.js 配置文件,架构的好坏都体现在这个配置文件中。

我们在工程所在的根目录,新建一个 webpack.config.js,初始化为:

var config = {};
module.exports = config;

如果 IDE 安装了支持 ES6 的编译插件,那么这里就可以直接使用 ES6 的导出语法:export default config;

接着,在 package.json 中的 scripts 内,配置 dev 属性,指向刚才新建的 webpack.config.js:

"scripts": {
    ...
    "dev":"webpack-dev-server --open --config webpack.config.js"
}

webpack-dev-server 命令配置属性如下:

属性 说明
config webpack-dev-server 配置文件路径。
open 浏览器打开的页面 URL,默认为 127.0.0.1:8080。如果配置了该选项,那么就会在命令执行成功后,打开浏览器。
host 浏览器打开的页面 IP 地址。
port 浏览器打开的页面端口号。

2 入口与出口配置

  • 入口配置的作用是告知 webpack 从哪里开始寻找依赖,然后 webpack 通过这些依赖执行编译操作。
  • 出口配置用于配置编译后的文件存储路径以及文件名称。

我们在项目根目录,新建一个 main.js 作为入口文件,然后在 webpack.config.js 中配置入口与出口。

var config = {
    entry: {
        main: './main'
    },
    output: {
        //目标输出目录
        path: '/public/assets',
        //资源文件引用目录
        publicPath: '/dist/',
        //输出文件的文件名
        filename: 'main.js'
    }
};
module.exports = config;
  • 在 entry 中配置入口,其中的 main,就是我们的配置入口,它指向的就是在 package.json 中配置的 main 所配置的 js 文件(这里是 main.js)。
  • 在 output 中配置出口,它有以下这些配置项:
属性 说明
filename 输出文件的文件名。
path 目标输出目录。
publicPath 资源文件引用目录。如果资源文件托管在 CDN 上,那么可以在此配置 CDN 地址。

最后,新建一个 index.html 作为主页面入口:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <style type="text/css">

    </style>
</head>
<body>

<div id="app">
    你好呀
</div>

<script src="dist/main.js"></script>
</body>
</html>

运行命令:

npm run dev

运行成功后,就会自动打开浏览器,进入 http://localhost:8080/。这时可以看到页面输出:

你好呀

修改 main.js 内容:

document.getElementById('app').innerHTML = '欢迎来到 webpack 世界,哈哈'

然后再回到浏览器,可以看到页面被自动刷新咯:

欢迎来到 webpack 世界,哈哈

这是 webpack-dev-server 的热更新特性,它会通过建立 WebSocket 连接来实时响应代码的变化。

main.js 被编译为拥有 387 行代码的脚本:

因为是开发模式,所以编译出的代码较多。

热更新时,控制台也会打印出相关信息:


控制台中想要退出当前命令状态,可以按 ctrl + c,来终止当前操作。

3 Cannot find module 'webpack-cli/bin/config-yargs'

如果运行 npm run dev,抛出异常:Error: Cannot find module 'webpack-cli/bin/config-yargs':

那么使用 npm 安装下 webpack-cli 即可:

npm i webpack-cli -D
  • i :是 install 的缩写。
  • -D :是 --save-dev 的缩写。

运行结果:


4 配置加载器(Loaders)

在 Webpack 中,每种文件都是一种模块,需要不同的加载器来处理。比如 css 文件就需要 style-loader 和 css-loader。我们使用 NPM 来安装这些加载器:

npm install css-loader --save-dev
npm install style-loader --save-dev

安装成功后,我们接着在 webpack.config.js 中配置 CSS 加载器:

var config = {
    module: {
        rules: [
            {
                test: /\.css$/,
                use: [
                    'style-loader',
                    'css-loader'
                ]
            }
        ]
    },
    entry: {
       ...
    },
    output: {
      ...
    }
};
module.exports = config;

我们可以在 module 的 rules 中,指定多个加载器。每个加载器都需要包含以下属性:

属性 说明
test 正则表达式
use 所使用的加载器。可以是字符串或数组;如果是数组,那么它的编译顺序是从后往前。

然后在根目录,新建一个 style.css 样式文件,内容为:

#app {
    font-size: 24px;
    color: #3399ff;
}

最后运行 npm run dev 命令。可以看到页面已被加入样式咯:

Webpack 是利用 JavaScript 来动态创建 <style> 标签,从而写入定义的样式:

这种方式,在实际项目中并不适用。因为一个项目可能有很多样式,如果都放在 JS 中,就会让脚本变得臃肿,影响性能。

5 配置插件(Plugins)

我们可以使用 extract-text-webpack-plugin 插件,把项目中分散的 CSS 样式集中起来,放入 main.css,最后在 index.html 中通过 <link> 来加载它。

安装 extract-text-webpack-plugin 插件。

npm install extract-text-webpack-plugin --save-dev

注意: 如果使用这个命令来安装该插件,那么默认会安装 3.0.2 版本,而这一版与 Webpack4.0+ 不兼容。

如果要安装兼容 Webpack4.0+ 版本的 extract-text-webpack-plugin 插件,请使用以下命令安装:

npm install extract-text-webpack-plugin@next --save-dev

这会安装 extract-text-webpack-plugin@4.0.0-beta.0。

在 webpack.config.js 中,配置好刚刚安装的插件:

//插件
var ExtractTextPlugin = require('extract-text-webpack-plugin');

var config = {
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ExtractTextPlugin.extract({//插件
                    use: 'css-loader',
                    fallback: 'style-loader'
                })
            }
        ]
    },
    entry: {
             ...
    },
    output: {
       ...
    },
    plugins: [//插件
        new ExtractTextPlugin('main.css')
    ]
};
module.exports = config;

再次运行 npm run dev

页面效果与刚才相同,只不过这时项目样式,已经是通过 <link> 引入的啦O(∩_∩)O~


Webpack 的关键部分是 js 配置,核心概念是入口、出口、加载器与插件。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容

  • 版权声明:本文为博主原创文章,未经博主允许不得转载。 webpack介绍和使用 一、webpack介绍 1、由来 ...
    it筱竹阅读 11,028评论 0 21
  • 写在前面的话 阅读本文之前,先看下面这个webpack的配置文件,如果每一项你都懂,那本文能带给你的收获也许就比较...
    不忘初心_9a16阅读 3,231评论 0 17
  • GitChat技术杂谈 前言 本文较长,为了节省你的阅读时间,在文前列写作思路如下: 什么是 webpack,它要...
    萧玄辞阅读 12,671评论 7 110
  • 写在开头 先说说为什么要写这篇文章, 最初的原因是组里的小朋友们看了webpack文档后, 表情都是这样的: (摘...
    Lefter阅读 5,273评论 4 31
  • SharePoint是个啥呢?它就是微软做的一个软件。 某个企业或者组织可以利用SharePoint来创建网站,可...
    幺幺是我阅读 25,191评论 0 1