webpack 之 使用篇

webpack 安装

前提条件:
确保安装了 node.js 最新版本,这是理想的起步。如果使用旧版本,可能会遇到各种问题,因为它可能缺少 webpack 功能或者缺少相关 package 包。

本地安装 (推荐)
要安装最新版本或者特定版本,请运行以下命令之一

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

对于大多数项目,建议本地安装。这可以使我们在引入破坏式(breaking change)变更的依赖时,更容易分别升级项目。

通常,webpack 通过运行一个或者多个 npm script,会在本地 node_modules 目录中查找安装的 webpack:

"script": {
    "start": "webpack --config webpack.config.js"
}

当你在本地安装 webpack 后,你能够从 node_modules/.bin/webpack 访问它的 bin 版本。

全局安装
以下 npm 的安装方式,将使 webpack 在全局环境下可用:

npm install -global webpack

不推荐全局安装 wabpack,这样做会将项目中的 webpack 锁定到指定版本,并且在使用不同的 webpack 版本项目中,可能会导致构建失败。

webpack 起步

源代码 (/src) 用于书写和编辑的代码
分发代码 (/dist) 构建过程产生的代码最小化和优化后的"输出"目录,最终在浏览器加载

文件夹目录结构

webpack-demo
|—— package.json
|—— /dist
    |—— index.html
|—— /src
    |—— index.js

示例:要在index.js中打包的jquery依赖,需要在本地安装

npm install --save jquery

然后,可以在脚本中 import jquery

import $ from 'jquery'

$('body').append('<h1>hello world</h1>')

现在,通过打包来合成脚本,要在 index.html 中通过一个 <script> 标签来加载 main.js 而不是原始的 /src 中的文件

<!doctype html>
  <html>
   <head>
     <title>起步</title>
   </head>
   <body>
     <script src="main.js"></script>
   </body>
  </html>

在这个设置中,index.js 显式要求引入 jquery 必须存在,然后将它绑定到 $ (没有全局作用域污染)。通过声明模块所需依赖,webpack 能够利用这些信息去构建依赖图,然后使用图生成一个优化过的,会以正确顺序执行的 main

可以这样说,执行 npx webpack,会将我们的脚本作为 入口起点,然后 输出 为 main.js。Node 8.2+ 版本提供的 npx 命令,可以运行在初始安装的 webpack 包(package)的 webpack 二进制文件(./node_modules/.bin/webpack

最后结果是在浏览器中打开 index.html,如果访问正常,可以看到 hello world ~

使用一个配置文件

使用配置文件的原因:在 webpack4 中,可以无需任何配置使用,可是大多数项目会需要很复杂的设置。支持配置文件比在终端中手动输入大量命令高效的多。

创建一个取代以上使用 CLI 选项方式的配置文件 webpack.config.js

webpack-demo
|—— package.json
|—— webpack.config.js        // 添加一个配置文件
|—— /dist
    |—— index.html
|—— /src
    |—— index.js

webpack.config.js

const path = require('path');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: 'bundle.js',
    path: path.resolve(__dirname, 'dist')
  }
};

然后再次构建

npx webpack   // 默认使用
npx webpack --config webpack.config.js

如果 webpack.config.js 存在,则 webpack 命令将默认选择使用它;而使用 --config 选项是说明,可以传递任何名称的配置文件。对于拆分成多个文件的负责配置是很有用的。

NPM 脚本 (NPMScript)

如果考虑到CLI方式运行本地的 webpack 不是很方便,命令长,可以设置一个快捷方式:在 package.json 添加一个 npm 脚本 (npm script):

{
  "name": "webpack-demo",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "webpack"   // 添加一个 npm 脚本
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "webpack": "^4.39.3",
    "webpack-cli": "^3.3.8"
  },
  "dependencies": {
    "jquery": "^3.4.1"
  }
}

现在就可以使用 npm run build 命令来代替之前使用的 npx 命令。使用 npm 的 script 可以像使用 npx 那样通过模块名引用本地安装的 npm 包。这是大多数基于 npm 的项目遵循的标准,因为它允许所有贡献者使用同一组通用脚本(如果有必要,每个 flag 都带有 --config 标志)

接着就是运行 npm run build,看看脚本是否能正常运行

通过向 npm run build 命令和参数之间添加两个中横线,可以将自定义参数传递给 webpack,例如:npm run build -- --colors

上述就是一个基本的构建过程

详见: 起步 | webpack

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

推荐阅读更多精彩内容

  • 作者:小 boy (沪江前端开发工程师)本文原创,转载请注明作者及出处。原文地址:https://www.smas...
    iKcamp阅读 2,752评论 0 18
  • 构建一个小项目——FlyBird,学习webpack和react。(本文成文于2017/2/25) 从webpac...
    布蕾布蕾阅读 16,815评论 31 98
  • 写在开头 先说说为什么要写这篇文章, 最初的原因是组里的小朋友们看了webpack文档后, 表情都是这样的: (摘...
    Lefter阅读 5,284评论 4 31
  • 前言 本质上,webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundl...
    Whyn阅读 445评论 0 1
  • 今天一早,照例去练习瑜伽,来到门口,发现瑜伽的一个超级忠实粉丝站在门口,我好奇地问:“怎么不进去?没开门?”忠粉点...
    开心书屋阅读 71评论 0 0