webpack

配置 webpack

在项目中安装和配置 webpack

1. npm install webpack webpack-cli -D
2. 在根目录中，创建名为 webpack.config.js 的webpack配置文件
3. 在 webpack.config.js 文件中配置如下：

module.exports = {
	mode: 'development' // mode 用来指定构建模式
}

4. 在 package.json 文件中的 scripts 节点下，新增 dev 脚本如下：

"scripts": {
	"dev": "webpack" // script 节点下的脚本，可以通过 npm run 执行
}

5. 在终端中运行 npm run dev 命令， 启动 webpack 进行项目打包

配置打包的入口与出口

webpack 的 4.x 版本中默认约定：

• 打包的入口文件为 src -> index.js
• 打包的输出文件为 dist -> main.js

如果要修改打包的入口与出口，可以在 webpack.config.js 中新增如下配置信息：

const path = require('path'); // 导入 node.js 中专门操作路径的模块
module.exports = {
	entry: path.join(__dirname, './src/index.js'), // 打包入口文件的路径
	output: {
		path: path.join(__dirname, './dist'), // 输出文件的存放路径
		filename: 'bundle.js' // 输出文件的名称
	}
}

webpack 自动打包功能

1. npm install webpack-dev-server -D
2. 修改 package.json -> scripts 中的 dev

"scripts": {
	"dev": "webpack-dev-server"
}

3. 将 src -> index.html 中的 script 脚本路径，改为绝对路径 “/buldle.js”
4. 运行 npm run dev 命令，重新打包
5. 在浏览器中访问 http://localhost:8080 可以查看自动打包后的效果

注意：
webpack-dev-server 会启动一个实时打包的 http 服务器
webpack-dev-server 打包生成的输出文件，默认放到了项目根目录中，而且是虚拟的，看不见

配置 html-webpack-plugin 生成预览页面

1. npm install html-webpack-plugin -D
2. 修改 webpack.config.js 文件头部区域，添加如下配置信息：

// 导入生成预览页面的插件，得到一个构造函数
const HtmlWebpackPlugin = require('html-webpack-plugin');
const htmlPlugin = new HtmlWebpackPlugin({ // 创建插件的实例对象
	template: './src/index.html', // 指定要用到的模板文件
	filename: 'index.html' // 指定生成文件的名称，该文件存在于内存中，在目录中不显示
});

3. 修改 webpack.config.js 文件中向外暴露的配置对象， 新增如下配置节点：

module.exports = {
	plugins: [ htmlPlugin ] // plugins 数组是 webpack 打包期间会用到的一些插件列表
};

配置自动打包相关的参数

// package.json 中的配置
// --open 打包完成后自动打开浏览器页面
// --host 配置 IP 地址
// --port 配置端口
"scripts": {
	"dev": "webpack-dev-server --open --host 127.0.0.1 --port 8888"
},

webpack 中的加载器

通过 loader 打包非 js 模块

在实际开发过程中，webpack 默认只能打包处理以 .js 后缀名结尾的模块，其他非 .js 后缀名结尾的模块，webpack 默认处理不了， 需要调用 loader 加载器才可以正常打包，否则会报错！

loader 加载器可以协助 webpack 打包处理特定的文件模块，比如：

• less-loader 可以打包处理 .less 相关的文件
• sass-loader 可以打包处理 .scss 相关的文件
• url-loader 可以打包处理 css 中与 url 路径相关的文件

loader 的调用过程：

打包处理 css 文件

1. npm i style-loader css-loader -D
2. 在 webpack.config.js 的module.exports中添加 module -> rules 数组中，添加 loader 规则如下：

// 所有第三方文件模块的匹配规则
module: {
	rules: [
		{ test: /\.css$/, use: ['style-loader', 'css-loader'] }
	]
}

其中，test 表示匹配的文件类型， use 表示对应要调用的 loader

注意：

• use 数组中指定的 loader 顺序是固定的
• 多个 loader 的调用顺序是：从后往前调用

打包处理 less 文件

1. npm i less-loader less -D
2. 在 webpack.config.js 中向外暴露的部分中添加如下 loader 规则：

// 所有第三方文件模块的匹配规则
module: {
	rules: [
		{ test: /\.less$/, use: ['style-loader', 'css-loader', 'less-loader'] }
	]
}

打包处理 scss 文件

1. npm i sass-loader node-sass -D
2. 在 webpack.config.js 中向外暴露的部分中添加如下 loader 规则：

module: {
	rules: [
		{ test: /\.scss$/, use: ['style-loader', 'css-loader', 'sass-loader'] }
	]
}

配置 postCSS 自动添加 css 的兼容前缀

1. npm i postcss-loader autoprefixer -D
2. 在项目根目录中创建 postcss 的配置文件 postcss.config.js，并初始化如下配置：

const autoprefixer = require('autoprefixer'); // 导入自动添加前缀的插件
module.exports = {
	plugins: [ autoprefixer ] // 挂载插件
}

3. 在 webpack.config.js 的module -> rules 数组中，修改 css 的 loader 规则如下：

module: {
	rules: [
		{ test: /\.css$/, use: ['style-loader', 'css-loader', 'postcss-loader'] }
	]
}

打包样式表中的图片和字体文件

1. npm i url-loader file-loader -D
2. 在 webpack.config.js 中向外暴露的部分中添加如下 loader 规则：

module: {
	rules: [
		{
			test: /\.jpg|png|gif|bmp|ttf|eot|svg|woff|woff2$/,
			use: 'url-loader?limit=16940'
		}
	]
}

其中 ? 之后的是 loader 的参数项
limit 用来指定图片的大小，单位时直接（byte），只有小于 limit 大小的图片，才会被转化为 base64 图片

打包处理 js 文件中的高级语法

1. 安装babel转换器相关的包：npm i babel-loader @babel/core @babel/runtime -D
2. 安装babel语法插件相关的包：npm i @babel/preset-env @babel/plugin-transform-runtime @babel/plugin-proposal-class-properties -D
3. 在项目根目录中，创建 babel 配置文件 babel.config.js 并初始化基本配置如下：

module.exports = {
	presets: [ '@babel/preset-env' ],
	plugins: [ '@bable/plugin-transform-runtime', '@babel/plugin-proposal-class-properties' ]
}

4. 在 webpack.config.js 的 module -> rules 数组中，添加 loader 规则如下：

// exclude 为排除项，表示 babel-loader 不需要处理 node_modules 中的 js 文件
{ test: /\.js$/, use: 'babel-loader', exclude: /node_modules/ }

webpack 中配置 vue 组件加载器

1. npm i vue-loader vue-template-compiler -D
2. 在 webpack.config.js 配置文件中，添加 vue-loader 的配置项如下：

const VueLoaderPlugin = require('vue-loader/lib/plugin')
module.exports = {
	module: {
		rules: [
			// ... 其它规则
			{ test: /\.vue$/, loader: 'vue-loader' }
		]
	},
	plugins: [
		// ... 其它插件
		new VueLoaderPlugin() // 请确保引入这个插件！
	]
}

webpack 打包发布

上线之前需要通过webpack将应用进行整体打包，可以通过 package.json 文件配置打包命令：

// 在package.json文件中配置 webpack 打包命令
// 该命令默认加载项目根目录中的webpack.config.js 配置文件
"scripts": {
	// 用于打包的命令
	"build": "webpack -p",
	// 用于开发调试的命令
	"dev": "webpack-dev-server --open --host 127.0.0.1 --port 3000"
},