webpack基础使用

安装

npm init -y     //目录下产生package.json文件
npm install webpack webpack-cli --save-dev

常见的project下有src目录和dist目录,src表示源,常用来放编译前的原始代码,dist表示分布,放编译后的代码,用于生产站点。

起步

假如我们的project目录如下

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

在index.js中引用了某个包,此时执行npx webpack,会将我们的脚本 src/index.js 作为入口起点,也会生成 dist/main.js 作为输出。此时dist中的index.html只引入main.js就能正常使用。


创建一个配置文件webpack.config.js


const path = require('path');

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

再通过新的配置文件再次执行构建:
npx webpack --config webpack.config.js

如果 webpack.config.js 存在,则 webpack 命令将默认选择使用它。我们在这里使用 --config 选项只是向你表明,可以传递任何名称的配置文件。这对于需要拆分成多个文件的复杂配置是非常有用。


考虑到用CLI方式运行本地webpack副本不是特别方便,我们可以在package.json的script中添加命令来代替我们之前使用的npx命令


{
    "name": "webpack-demo",
    "version": "1.0.0",
    "description": "",
    "scripts": {
      "test": "echo \"Error: no test specified\" && exit 1",
+     "build": "webpack"            //npx webpack
    },
    "keywords": [],
    "author": "",
    "license": "ISC",
    "devDependencies": {
      "webpack": "^4.20.2",
      "webpack-cli": "^3.1.2"
    },
    "dependencies": {
      "lodash": "^4.17.5"
    }
  }

管理资源

webpack也可以管理其他资源例如css、images

加载CSS

为了在 JavaScript 模块中 import 一个 CSS 文件,你需要安装 style-loader 和 css-loader,并在 module 配置 中添加这些 loader:

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

webpack.config.js

 const path = require('path');

  module.exports = {
    entry: './src/index.js',
    output: {
      filename: 'bundle.js',
      path: path.resolve(__dirname, 'dist')
    },
+   module: {
+     rules: [
+       {
+         test: /\.css$/,
+         use: [
+           'style-loader',
+           'css-loader'
+         ]
+       }
+     ]
+   }
  };

此时在src中添加css文件,并引入到index.js中,打包后css内容会出现在最终页面的head标签内。

现有的 loader 可以支持任何你可以想到的 CSS 风格 - postcss, sass 和 less 等

加载images

类似css,先安装,再配置module

npm install --save-dev file-loader

在配置文件的module下rules加

+       {
+         test: /\.(png|svg|jpg|gif)$/,
+         use: [
+           'file-loader'
+         ]
+       }

同理,src下添加图片,index.js中引用,css文件中使用,构建并打开最终文件,图片就正常显示了

加载 fonts 字体

file-loader 和 url-loader 可以接收并加载任何文件,然后将其输出到构建目录。这就是说,我们可以将它们用于任何类型的文件,也包括字体。因此我们只需更新配置文件:

+       {
+         test: /\.(woff|woff2|eot|ttf|otf)$/,
+         use: [
+           'file-loader'
+         ]
+       }
加载数据

加载的有用资源还有数据,如 JSON 文件,CSV、TSV 和 XML。类似于 NodeJS,JSON 支持实际上是内置的,也就是说 import Data from './data.json' 默认将正常运行。
要导入 CSV、TSV 和 XML,你可以使用 csv-loader 和 xml-loader

npm install --save-dev csv-loader xml-loader

配置:

+       {
+         test: /\.(csv|tsv)$/,
+         use: [
+           'csv-loader'
+         ]
+       },
+       {
+         test: /\.xml$/,
+         use: [
+           'xml-loader'
+         ]
+       }

管理输出

当我们需要分包,就需要输出不止一个js文件,因此修改配置文件:

 const path = require('path');

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

这样打包后会产生print.bundle.jsapp.bundle.js两个文件,如果手动修改index.html中的引用,就是正常显示,也可以用htmlWebpackPlugin来帮助解决


具体方法:安装插件

npm install --save-dev html-webpack-plugin

修改配置文件

   const path = require('path');
+ const HtmlWebpackPlugin = require('html-webpack-plugin');

  module.exports = {
    entry: {
      app: './src/index.js',
      print: './src/print.js'
    },
+   plugins: [
+     new HtmlWebpackPlugin({
+       title: '管理输出'
+     })
+   ],
    output: {
      filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

这样在编译之后插件会创建一个全新的index.html并替换我们的原有文件


清理/dist文件夹
推荐做法是每次编译前清理这个文件夹,这样只会生成用到的文件。可以用clean-webpack-plugin这个插件:

npm install --save-dev clean-webpack-plugin
  const path = require('path');
  const HtmlWebpackPlugin = require('html-webpack-plugin');
+ const CleanWebpackPlugin = require('clean-webpack-plugin');

  module.exports = {
    entry: {
      app: './src/index.js',
      print: './src/print.js'
    },
    plugins: [
+     new CleanWebpackPlugin(),
      new HtmlWebpackPlugin({
        title: '管理输出'
      })
    ],
    output: {
      filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

你可能会很感兴趣,webpack 和 webpack 插件似乎“知道”应该哪些文件生成。答案是,webpack 通过 manifest,可以追踪所有模块到输出 bundle 之间的映射。

如果你想要知道如何以其他方式来控制 webpack 输出,了解 manifest 是个好的开始。

通过 WebpackManifestPlugin 插件,可以将 manifest 数据提取为一个容易使用的 json 文件。

开发/调试

source map定位

webpack打包源码后,我们有可能很难追踪到错误和警告在源码中的位置。

使用source map就可以准确定位了,它会将编译后的代码映射回原始代码。它有很多不同的选项可以使用,可以根据需要进行配置。

开发工具

我们在开发调试的过程中经常需要编译代码,每次手动输入npm run build太麻烦,webpack提供了几个选项,帮助我们在代码变化后自动编译:

  1. 观察模式watch

在package.json的script中加入"watch": "webpack --watch",即可在命令行中npm run watch观察代码,改动后需要手动刷新浏览器

  1. webpack-dev-server
npm install --save-dev webpack-dev-server

在webpack.config.js的module.exports中添加

devServer: {
     contentBase: './dist'
 }

以上配置告知webpack-dev-server,在localhost:8080下建立服务,将dist下的文件,作为可访问文件。

依然在scripts中添加命令"start": "webpack-dev-server --open",在命令行中运行 npm start,就会看到浏览器自动加载页面。如果现在修改和保存任意源文件,web 服务器就会自动重新加载编译后的代码

webpack-dev-server的其他设置可以在这里看到

  1. webpack-dev-middleware
    webpack-dev-middleware因为笔者没用过这个,就只放链接供大家参考=。=

参考

webpack教程

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

推荐阅读更多精彩内容

  • 网页静态资源 1.在网页中会引用哪些常见的静态资源? JS .js .jsx .coffee .ts(Typ...
    云翼飞阅读 412评论 0 0
  • 上一篇《什么是构建?webpack打包思想》webpack是在node环境里跑的,所以先搭建构建环境。node的安...
    下一站深圳阅读 894评论 0 2
  • webpack使用学习 本分享学习借鉴webpack中文官网,官网链接(中文文档):https://www.web...
    腿毛怪丶叔叔阅读 880评论 0 5
  • 全局安装webpack 全局安装webpack会有个问题,就是当你有两个项目依赖于不同版本的webpack,就会有...
    説好的妹紙呢阅读 1,816评论 0 11
  • 前言 本质上,webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundl...
    Whyn阅读 445评论 0 1