webpack是什么?
官网对其概念的解释:
本质上,webpack 是一个用于现代 JavaScript 应用程序的 静态模块打包工具。当 webpack 处理应用程序时,它会在内部从一个或多个入口点构建一个 依赖图(dependency graph),然后将你项目中所需的每一个模块组合成一个或多个 bundles,它们均为静态资源,用于展示你的内容。
在开始实例之前,需要先理解一些核心概念:
入口(entry)
入口起点(entry point) 指示 webpack 应该使用哪个模块,来作为构建其内部 依赖图(dependency graph) 的开始。进入入口起点后,webpack 会找出有哪些模块和库是入口起点(直接和间接)依赖的。
默认值是 ./src/index.js
,但你可以通过在 webpack configuration 中配置 entry
属性,来指定一个(或多个)不同的入口起点。例如:
webpack.config.js
module.exports = {
entry: 'main.js',
};
输出(output)
output 属性告诉 webpack 在哪里输出它所创建的 bundle,以及如何命名这些文件。主要输出文件的默认值是 ./dist/main.js
,其他生成文件默认放置在 ./dist
文件夹中。
你可以通过在配置中指定一个 output
字段,来配置这些处理过程:
webpack.config.js
const path = require('path');
module.exports = {
entry: 'main.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'bundle.js',
},
};
在上面的示例中,我们通过 output.filename
和 output.path
属性,来告诉 webpack bundle 的名称,以及我们想要 bundle 生成(emit)到哪里。可能你想要了解在代码最上面导入的 path 模块是什么,它是一个 Node.js 核心模块,用于操作文件路径。
loader
webpack 只能理解 JavaScript 和 JSON 文件,这是 webpack 开箱可用的自带能力。loader 让 webpack 能够去处理其他类型的文件,并将它们转换为有效 模块,以供应用程序使用,以及被添加到依赖图中。
在更高层面,在 webpack 的配置中,loader 有两个属性:
1、test
属性,识别出哪些文件会被转换。
2、use
属性,定义出在进行转换时,应该使用哪个 loader。
webpack.config.js
const path = require('path');
module.exports = {
output: {
filename: 'mbundle.js',
},
module: {
rules: [
{
test: /\.css$/,
use: ['style-loader', 'css-loader']
}
],
},
};
以上配置中,对一个单独的 module 对象定义了 rules
属性,里面包含两个必须属性:test
和 use
。
插件(plugin)
loader 用于转换某些类型的模块,而插件则可以用于执行范围更广的任务。包括:打包优化,资源管理,注入环境变量。
想要使用一个插件,你只需要 require()
它,然后把它添加到 plugins
数组中。多数插件可以通过选项(option)自定义。你也可以在一个配置文件中因为不同目的而多次使用同一个插件,这时需要通过使用 new
操作符来创建一个插件实例。
webpack.config.js
const HtmlWebpackPlugin = require('html-webpack-plugin'); // 通过 npm 安装
const webpack = require('webpack'); // 用于访问内置插件
module.exports = {
module: {
rules: [
{
test: /\.css$/,
use: ['style-loader', 'css-loader']
}
],
},
plugins: [new HtmlWebpackPlugin({ template: './src/index.html' })],
};
模式(mode)
通过选择 development
, production
或 none
之中的一个,来设置 mode
参数,你可以启用 webpack 内置在相应环境下的优化。其默认值为 production
。
module.exports = {
mode: 'production',
};
浏览器兼容性(browser compatibility)
Webpack 支持所有符合 ES5 标准 的浏览器(不支持 IE8 及以下版本)。webpack 的 import()
和 require.ensure()
需要 Promise
。如果你想要支持旧版本浏览器,在使用这些表达式之前,还需要 提前加载 polyfill。
环境(environment)
Webpack 5 运行于 Node.js v10.13.0+ 的版本。
webpack基本使用
1、首先,全局安装webpack
npm install -g webpack webpack-cli
2、初始化项目
创建webpack-project文件夹,进入,执行命令
npm init -y
安装依赖
npm install
创建src文件夹,在文件夹里面创建main.js文件
在根目录创建一个index.html
这个时候需要使用webpack.config.js来构建(打包)为bundle.js
在根目录创建webpack.config.js
const path = require("path"); //Node.js内置模块
module.exports = {
entry: './src/main.js', //配置入口文件
output: {
path: path.resolve(__dirname, './dist'), //输出路径,__dirname:当前文件所在路径
filename: 'bundle.js' //输出文件
}
}
直接执行webpack进行打包,会有警告
查看文档,在打包时候指定当前模式
我们使用模式为开发环境进行打包,没有警告
webpack --mode=development
也可以配置项目的npm运行命令,修改package.json文件
直接执行
npm run build
打包成功,查看目录结构,与webpack.config.js的出口指定路径、文件名一致
将index.html内容修改成如下,引入刚刚打好的包
<html>
<body>
<script type="text/javascript" src="dist/bundle.js"></script>
</body>
</html>
在浏览器打开index.html,验证打包成功
多入口文件,在多页面应用中,每个页面拥有不同的入口文件,用这个就非常管用了。
在src文件夹下新增other.js
document.write('<h1>Other content</h1>')
修改webpack.config.js,注意入口文件变成了多个,出口文件变成对应的js,如bundle1.js
const path = require("path"); //Node.js内置模块
module.exports = {
entry: {
//配置多入口文件'
bundle1:'./src/main.js',
bundle2:'./src/other.js'
},
output: {
path: path.resolve(__dirname, './dist'), //输出路径,__dirname:当前文件所在路径
filename: '[name].js' //输出文件
}
}
然后执行打包命令
npm run build
打包成功
修改index.html并在浏览器打开,验证打包成功
<html>
<body>
<script type="text/javascript" src="dist/bundle1.js"></script>
<script type="text/javascript" src="dist/bundle2.js"></script>
</body>
</html>
以上就是webpack打包涉及到的一些文件与基本流程,当然,webpack的作用远远不止于此,当我们需要构建复杂项目时,webpack.config.js中的配置也会变得复杂多样,会出现许多的loader与plugin。下篇就介绍一些常用的loader和plugin,如Babel-loader、CSS-loader、HTML Webpack Plugin等等。
下篇再见,敬请关注。
参考链接:概念 | webpack 中文文档