初识 webpack

1. 初始化项目

首先,让我们用命令行创建一个名为 webapp 的项目文件夹,初始化 npm,本地安装 webpack

// 命令行 输入:
mkdir webapp && cd webapp
npm init -y
npm install --save-dev webpack

如果你是初次接触 npm和命令行工具,建议看看我的这篇 npm 应用基础

运行了上述命令以后,在你本地的 webapp 项目文件夹创建一个包含 index.js 文件的 src(source的缩写)文件夹,和一个包含 index.html 文件的 dist(distribution的缩写)的文件夹。顾名思义, src 文件夹中放置我们的源代码, dist 文件夹是我们发布的项目文件夹。这时候你 webapp 文件夹应该包含如下文件:

// webapp 文件夹目录结构:
   webapp
   |- package.json
   |- /src
     |- index.js
   |- /dist
     |- index.html

编写 index.html 文件内容如下:

// index.html 内容:
<html>
<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>
<body>
    <script src="bundle.js"></script>  <!-- 这个 bundle.js 将要使用webpack生成 -->
</body>
</html>

现在如果打开这个网页,会报错找不到 bundle.js 文件。不用担心,我们接下来就用 webpack 命令行生成这个文件。

2. 生成主 js 文件

首先,我们要编写 index.js 文件内容如下:

// index.js 内容:
import _ from 'lodash';    // webpack 支持多种模块引用语法,包括CommonJs,AMD以及ES6。我推荐使用ES6语法,以后我会写文章专门解释他们的区别。

function component() {
    var element = document.createElement('div');
    element.innerHTML = _.join( ['Hello', 'webpack'], ' ' );
    return element;
}

document.body.appendChild( component() );

可以看到,我们的项目入口 js 文件是 index.js,它引用了 lodash 模块,所以在生成主 js 文件前,我们需要安装 lodash 依赖:

// 命令行 输入:
npm install --save lodash 

安装完成后,package.json 文件中的出一个 dependencies 的对象,该对象包含一个 lodash 属性。

可能细心的你注意到了,我们安装 webpack 的时候用了 --save-dev 选项,但是安装lodash的时候用了--save选项。并且,在package.json 文件中,webpacklodash 也分别出现在了 devDependenciesdependencies 对象中。这里的--save表示保存为依赖(dependency),依赖项就是运行我们的项目所必须的模块,而-save-dev表示保存为开发依赖(development dependency),是我们开发的时候所必须的模块,但并不是运行项目或者在生产环境下必须的模块。两者一个显著的特征区别就是当我们在命令行执行npm install时,npm 只会帮我们安装 dependencies 对象中的依赖模块。

然后我们可以通过命令行将 index.js 连同依赖的 lodash 一起打包成一个名为 bundle.js 的主文件:

// 命令行 输入:
./node_modules/.bin/webpack  src/index.js  dist/bundle.js

好吧,我承认这是一个蹩脚的写法。并且windows下路径连接符还需要用\
但是,我们成功地使用 webpack 生成了一个 bundle.js 文件,并且我们在浏览器打开 index.html 文件,可以看到“Hello webpack”。下面我要讲解如何简单地配置 webpack 使我们可以简化上述命令。

3. 简单配置 webpack

在我们的项目文件夹下创建一个 webpack.config.js 文件,如下:

// webapp 文件夹目录结构:
   webapp
   |- package.json
*  |- webpack.config.js
   |- /src
     |- index.js
   |- /dist
     |- index.html
     |- bundle.js

并按照如下代码编辑 webpack.config.js 文件:

// webpack.config.js 内容:
const path = require('path');   // path是node内置的模块

module.exports = {
  entry: './src/index.js',      // 入口文件的相对路径
  output: {                     // 输出
    filename: 'bundle.js',                    // 文件名
    path: path.resolve(__dirname, 'dist')     // 文件所在目录的绝对路径
  }
};

这时候我们只需在命令行内输入:

// 命令行 输入:
// Linux, Mac 下:
./node_modules/.bin/webpack
// 或者 windows:
.\node_modules\.bin\webpack

就能生成 bundle.js 文件。如果我们还想进一步简化该命令,我们就需要修改 package.json 文件的 “scripts” 对象了。

4. 配置 package.json 的 scripts

package.jsonscripts 对象负责存放我们自定义的命令行命令,该对象的每个属性对应了一个命令,属性名为我们在npm run后面输入的命令的名称,属性值为这个命令。因此,我们可以这样修改 package.json

// package.json 内容:
{
  ...
  "scripts": {
    "build": "webpack"    //这里不用再写安装路径了
  },
  ...
}

注意在 scripts 对象里,我们可以访问本地安装的 npm 包,而不用再写这些包的安装路径了。所以,最终我们输入如下命令就能完成我们的工作了:

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

推荐阅读更多精彩内容